This guide will describe how to setup the integration between Okta (a Single Sign On service) with GaggleAMP. It will allow Managers and Members to sign in to or sign up for GaggleAMP from the Okta dashboard without a password.
To enable the integration follow the following steps:
1. Submit a Request
Contact GaggleAMP Support via the application or by emailing firstname.lastname@example.org with “I would like to enable Okta integration for my Gaggle”
GaggleAMP Support will respond with a special link that you or your IT team can use to configure Okta inside GaggleAMP.
The person in your organization responsible for managing Okta will need to create a new application for GaggleAMP in your company’s Okta instance.
2. Create New Application in Okta
Go to the "Applications" menu and click "Add Application" afterward. On the next page, click the green "Create New App" button (top section of the left sidebar).
Enter GaggleAMP’s SAML Settings. Okta provides 3 pages in wizard style for setting up the SAML Service Provider configuration. The significant part is the 2nd step (SAML Settings)
These are the values required for the integrating with our end:
Single sign on URL: https://accounts.gaggleamp.com/auth/saml/callback
Use this for Recipient URL and Destination URL: checked
Name ID format: EmailAddress
Application username: Email
- After the application is created, Okta presents the user with the "details" page of the application. On this page, Okta provides the "Identity Provider Metadata" URL, this link will need to be supplied on the special link that GaggleAMP generated for your organization in order to automatically configure Okta. In addition to the metadata URL, you will also need to retrieve the "Identity Provider Issuer" value.
Using the configuration values noted in the previous section, you will need to visit the special link that GaggleAMP Support provided you and enter the request values:
3. Submit Your Okta Configuration to GaggleAMP