Quick start

Connect2id server requirements

	2+ GBytes of RAM If you expect to service more than 100 thousand users the server will benefit from additional memory.
	Java 17 Make sure the Java runtime has the latest security patches.
	Database A database for the server to persist its data, such as a client registrations and authorisations. You have choice between MySQL, PostgreSQL, Microsoft SQL Server, Oracle Database, H2, DynamoDB and Redis.
	Jakarta Servlet 6.0+ Container An Apache Tomcat 10.1 web server is included in the download package. Other Servlet 6.0+ compliant containers are also supported.

Setup

Step 1.

Unzip the downloaded Connect2id server package.

Step 2.

Start the Apache Tomcat web server with

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

It contains preconfigured instances of the Connect2id server and an H2 database for its data, a demo login page, an LdapAuth service for authenticating users against a sample in-memory LDAP directory, and an OpenID Connect client.

To access the Tomcat management panel go to

http://127.0.0.1:8080/manager

and enter:

• 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 will see a banner page, listing the standard OAuth 2.0 / OpenID Connect endpoints and the server web APIs for integrating UIs, management and monitoring tools.

Step 4.

Launch the demo OpenID Connect client to test user authentication and profile retrieval with the Connect2id server:

http://127.0.0.1:8080/oidc-client

Docker

Docker images for the Connect2id server are also available.

Questions or comments?

Get in touch with Connect2id support.