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 17
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 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 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 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 the 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 web APIs for integrating UIs, management and tools.

Step 4.

Launch the demo 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.