osiam / connector4java-integration-tests

The integration tests for the OSIAM connector4java

OSIAM - Open Source Identity and Access Management

Active development of this project has stopped.

OSIAM is a secure identity management solution providing REST based services for authentication and authorization. We achieve this by implementing two important open standards:

• OAuth 2.0
• SCIM 2.0

OSIAM is published under the MIT licence, giving you the greatest freedom possible to utilize OSIAM in you project or product. Watch our blog to stay informed about releases and upcoming changes.

Use cases

• Single app with OSIAM as free backing store for users and groups and local auth service.
• Distributed app with OSIAM as central identity store and auth service.
• Publish your app's API with OSIAM as auth service for 3rd-parties and allow safe access to your user's data.

Quick Start

Download the latest version of OSIAM:

curl -L https://dl.bintray.com/osiam/downloads/osiam/3.0/osiam-3.0.war -o osiam.war

Make the .war file executable:

chmod +x osiam.war

Start OSIAM:

./osiam.war

After some seconds, OSIAM should be fully running. You can now retrieve your first access token:

curl -H "Authorization: Basic ZXhhbXBsZS1jbGllbnQ6c2VjcmV0" -X POST -d "grant_type=client_credentials&scope=ADMIN" http://localhost:8080/oauth/token

You can now start to setup OSIAM, by changing the administrator's password and add your own OAuth client. Please see the Installation and Configuration Manual for details.

Documentation

Learn how to install and configure OSIAM for production in the documentation.

Components

• osiam handles the authentication and authorization based on OAuth 2.0 and holds the SCIM based user data
• addon-self-administration provides account management self-service as a web application
• addon-administration lets you administer users and groups via a web application

Easy customization

Every visual aspect of OSIAM's components can be easily customized by supplying your own templates, stylesheets and scripts to make OSIAM integrate seamlessly with your application. Read the customization guide to learn more.

Snapshots

To use the latest snapshot of OSIAM just download it from JFrog OSS: https://oss.jfrog.org/repo/org/osiam/osiam/latest-SNAPSHOT/

Scroll down to the bottom of the page and select the latest WAR file.

Issue Tracker

Please report issues, bugs and feature requests via [the issue tracker] (https://github.com/osiam/osiam/issues).

Get involved

Help is very appreciated. Please read the contributors guide to learn how to get started.

connector4java-integration-tests's Issues

Move ITs to respective projects

There are too many system integrations tests. Most of the stuff here should be moved to the respective services as service integration tests. We should only maintain some crucial, happy path tests and tests that are only valid when testing against the complete system.

Do not run mysql and postgresql on default ports

If a developer has a mysql and/or postgresql installation running on they local machine, the docker database containers maybe clashes with the already bind ports. Also the CircleCI config step of uninstall the already start up database servers can be removed.

Cross Project Debugging?

Hello,

I am working on an issue in the resource-server. I have tests in the connector4java-integration-tests project to show if the bug is fixed. My question is: How can I debug code in the resource-server?

Here is what I tried:

• mvn clean pre-integration-test in the IT project
• Run test in the IDE

I want a breakpoint here. I was not able to open FilterConstraint in the IT project in my IDE. Stepping from the IT does also not seem to be a viable option.

In case this is relevant: I am using IntelliJ Ultimate 14.1.4 and open jdk on Ubuntu vivid, as well as the official Docker (not from the Ubuntu repos).

Remove explicit installation of Docker 1.6.2

CircleCI has updated to Docker 1.6.2, so it's time to remove this line.

Cache Docker images

Currently we have to download all Docker images, like mysql, postgres, tomcat, before the test are run. We should put these images into the build cache of CircleCI, i.e. by exporting them to some folder and then add that folder to the cache.

Remove all old hashes from database seeds

Not all sha password hashes were removed from the database seeds until the switch to bcrypt hashes. It's not a problem now, because osiam supports both hashes, but this must happen soon.

Just search with the regex password="[^\$] all *.xml files in this project.

The test to search users with a complex query fails

The CompleteUserIT.search_for_user_by_complex_query fails because a read timeout of the client occurred. Only with postgres and not always. The test search users with all possible attributes set. Maybe this isn't a "real life" scenario and we can split the test into multiple tests to verify that users can be found with every attribute?

Migrate to CircleCI 2.0

I think we just need to follow the migration guide:
https://circleci.com/docs/2.0/migrating-from-1-2/

Use the CircleCI cache for Maven dependencies

Migrate to Gradle

Documentation for Docker Usage

Running the tests requires a Docker configuration that is not obvious in order to let Java communicate with Docker. This should be briefly described in the README.

The error message describing this problem reads like

[ERROR] Failed to execute goal com.alexecollins.docker:docker-maven-plugin:2.9.2:clean (clean-docker-images) on project integration-tests: org.apache.http.conn.HttpHostConnectException: Connect to localhost:2375 [localhost/127.0.0.1] failed: Connection refused -> [Help 1]

Remove tests of addon-self-administration

Tests have to be deleted after osiam/addon-self-administration#162 has been resolved.

Part of: osiam/osiam#93

Bring back verification of sent emails

Running the tests with Docker had the disadvantage that we couldn't retrieve the sent emails (e.g. from the self administration) from Greenmail to verify them. At least this was not possible as easily as before. We should re-activate these tests by connecting to the POP3 interface of Greenmail and get the latest received mail. Does anyone know a simple POP3 client?

Collect test metadata within Circle CI

https://circleci.com/docs/test-metadata#java-junit-results-with-maven-surefire-plugin