Quick start

Connect2id server requirements

	2+ GBytes of RAM If you expect to service more than 100 thousand users the server will benefit from extra available memory.
	Java 11+ Make sure the Java runtime is up to date with the latest security patches.
	Database A database for the server to persist its data, such as a client registrations and sticky grants. MySQL, PostgreSQL, Microsoft SQL Server, H2, LDAP, DynamoDB and Redis are supported.
	Java Servlet 3.0+ Container An Apache Tomcat web server is included in the download package. Other servlet v3.0+ compliant containers are also supported.

Setup

Step 1.

Unzip the downloaded Connect2id server package in a suitable directory.

Step 2.

Start the Apache Tomcat web server, which has preinstalled and configured instances of the Connect2id server and an H2 database for persisting its data, a demo login page, an LdapAuth service for authenticating users against an in-memory LDAP directory, and an OpenID Connect client.

To start Apache Tomcat:

connect2id-server-[version]/tomcat/bin/startup.sh

To access the Tomcat management panel go to

http://127.0.0.1:8080/manager

and enter the following admin credentials:

Username: admin
Password: secret

Step 3.

Point your favourite browser to the base URL of the Connect2id server:

http://127.0.0.1:8080/c2id

You should see a banner page, listing the standard OAuth 2.0 / OpenID Connect endpoints provided by the server. There’s also a list of server web APIs for integrating UIs and custom components.

Step 4.

Launch the example OpenID Connect client to test authentication and UserInfo retrieval with the Connect2id server:

http://127.0.0.1:8080/oidc-client

Docker

We also provide an image to evaluate the Connect2id server in a Docker container.

Questions or comments?

Get in touch with Connect2id support.