You can use Microsoft Active Directory Federation Services (ADFS) as an identity provider for users in Aha! based on SAML 2.0. You will need to be an administrator in Aha! Ideas and in ADFS to configure SSO.
Click any of the following links to skip ahead:
In ADFS
In Server Manager, click Tools → AD FS Management.
Click Add Relying Party Trust under Actions. This will open the Add Relying Party Trust Wizard.
In the Welcome step, click Claims aware, then Start.
-
In the Select Data Source step, choose Import data about the relying party, then enter your Aha! account URL in the Federation metadata address field. You can copy the URL from the Aha! ideas portal SSO settings by navigating to Users → SSO.
The metadata URL will only work once SAML authentication is enabled in your Aha! account.
In the Specify Display Name step, name your relying party (e.g. "Aha!").
The Configure Certificate step is optional. Click Next.
The Configure URL step is optional. Click Next.
In the Configure Identifiers step, enter your Aha! account URL. You can copy the URL from the Aha! ideas portal SSO settings by navigating to Users → SSO.
In the Choose Access Control Policy step, choose to Permit everyone.
Review your settings on the Ready to Add Trust step, then click Next.
On the Finish step, click Close. This will open the Edit Claim Rules modal.
On the Issuance Transform Rules tab, click Add Rule....
Select the Send LDAP Attributes as Claims template.
-
Click Next. Name your rule, select Active Directory as the attribute store, and then add the following mappings:
LDAP Attribute
Outgoing Claim Type
NameID
NameID
Given-Name
Given Name
Surname
Surname
Each user in your Aha! account needs to have a unique NameID. This value must be unique — an email addresses cannot be used as a NameID. This ensures that any changes to a user's email address can be reflected in your Aha! account.
Click OK.
On the Issuance Transform Rules tab, click Add Rule... again.
Select the Transform an Incoming Claim template, then click Next.
-
Name the rule and make the following selections:
Incoming claim type: NameID
Outgoing claim type: NameID
Outgoing name ID format: Email
Pass through all claim values
Click OK.
In Aha!
-
Navigate to Settings ⚙️→ Account → Ideas →Ideas portals or Ideas → Overview. You will need to be an administrator with customizations permissions to configure an ideas portal.
From your account settings, click the name of the ideas portal you wish to edit.
From Ideas → Overview, click the pencil icon by the name of the ideas portal you wish to edit.
Once you have your portal settings open, navigate to the Users tab, and the SSO section.
Select SAML 2.0 from the Identify Provider dropdown. The SAML 2.0 configuration will display.
Name your configuration.
For the Metadata URL, enter the URL to the metadata xml listed in AD FS 2.0 console, e.g. https://adfs.<company>.com/FederationMetadata/2007-06/FederationMetadata.xml.
Enter the remaining fields following the SAML 2.0 configuration instructions.
Click Enable SSO to complete the configuration.
Share your SSO configuration between portals (Advanced plan)
If you have added Ideas Advanced functionality to your Aha! account, the process to create and assign an identity provider looks a little different.
Follow the same steps in ADFS listed above.
-
Navigate to Settings ⚙️→ Account → Ideas portals or Ideas → Overview. You will need to be an administrator with customizations permissions to configure an ideas portal.
From your account settings, click the name of the ideas portal you wish to edit.
From Ideas → Overview, click the pencil icon by the name of the ideas portal you wish to edit.
Once you have your portal settings open, navigate to the Users tab, then the SSO section.
-
Select Add new provider from the Identify Provider dropdown.
Name: Name your identity provider.
Note: We recommend that you name your provider something easily recognizable to the different portals that might want to use it, like Employees, or Customers.Type: Choose SAML as your identity provider type.
Click Save and continue in Aha!
Enter the remaining fields following the SAML 2.0 configuration instructions.
Click Enable SSO to enable your identity provider.
To share your identity provider configuration between multiple ideas portals:
Open each portal's settings.
Once you have your portal settings open, navigate to the Users tab, then the SSO section.
Select the identity provider you just created from the Identity provider dropdown.
Congratulations! You just shared your configuration with another portal.
Repeat these steps for each portal you wish to use the shared Identity provider configuration.
You can manage your identity provider configuration — and the portals that use it — from the Identity providers tab in Settings ⚙️→ Account → Ideas portals.
Troubleshooting
If you run into trouble, we have gathered common SSO configuration issues into one article, along with common resolutions.
The best place to start in most of these situations is the integration log messages for your SSO configuration. Those messages will help diagnose and solve the problem.