Organization settings
Last updated
Last updated
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:
Be an organization owner.
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:
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)
We highly recommend to use this option, most especially the one where you provide the metadata file using an url. This allows automatic certificate update without service interruption.
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:
After enabling SSO, all users will be required to log in again.
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):
Check the steps below this if you encounter an issue:
Double check all information (endpoints, certificate expiration dates, etc..)
Make sure the NameID configured 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
If you can't find anything by yourself don't hesitate to ask for help on our Community forum
