Organization settings
Your Organization settings are accessible from the top-right dropdown:
The overview tab gathers the basic settings of your Organization: here you'll be able to edit
- its name
- its logo
or delete it permanently.
In this tab you can manage your Organization Owners. Owners are simply users who have access to the Organization settings.
A user must belong to at least 1 project of the Organization to be invited as an Owner and will be automatically added as Admin on all projects of the Organization
You need to be on a Forest Admin Pro plan to have access to this feature. You need a least one project within this organization with this plan to gain access to this feature
This tab gathers all security options of your Organization. For now you can only configure Single Sign-On (SSO).
We are supporting the SAML 2.0 specifications, you can use all the main Identity Providers.
For instance, the following platforms have been tested and documented: Okta, OneLogin, Google and Azure Active Directory IdPs.
To configure SSO for your organization, you must:
- Have access to your Identity Provider.
You'll first need to declare Forest Admin in your Identity Provider using the information in the grey panel:
Setting | Description | Value |
|---|---|---|
Callback URL (Assertion Consumer Service URL)* | Assertion Consumer Service URL is responsible for receiving the SAML response | https://api.forestadmin.com/api/saml/callback |
Sign on URL* | Sign on URL | https://api.forestadmin.com/api/saml/callback |
Logout URL | Redirected to this location after logout | https://app.forestadmin.com/login (⚠️ Or your custom domain if you use one) |
Audience (EntityID) | Named SP Entity ID in Forest Admin | Value is displayed in the Forest Admin settings |
XML file upload or XML file endpoint (Recommended)
Either upload a file containing the authentication information (you'll be able to generate this file in your Identify Provider) or input the endpoint at which such a file is available (some IPs provide this).
Manual input
You may also enter your authentication information manually. You'll need to provide:
- a Login endpoint
- a Logout endpoint
- and finally a Valid certificate
Click on Test configuration to try to authenticate.
If it works, you're all set but you will still need to enable that new SSO authentication method:
Once you have enabled SSO, you have the option to enable IdP-initiated login: this will allow your users to be automatically logged in when they come to Forest Admin from your identity provider dashboard.
To set it up properly, you will need to set a default Relay state on your identity provider following this format (or URL encoded depending on the IdP):
{
"organizationName": "OrganizationName",
"destinationUrl": "organization.projects"
}
Check the steps below this if you encounter an issue:
- Double check all information (endpoints, certificate expiration dates, etc..)
- Make sure the
NameIDconfigured on your Identity Provider is the email address used on Forest Admin accounts too - Make sure you selected SAML 2.0 on your Identity Provider
Last modified 26d ago