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 long-lived authorisations. 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.

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.