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
and enter the following admin credentials:
- Username:
admin
- Password:
secret
Step 3.
Point your favourite browser to the base URL of the Connect2id server:
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.