Set Up User Access to Oracle Fusion Data Intelligence Using Single Sign-On
You can set up how users from Oracle Fusion Cloud Applications access Oracle Fusion Data Intelligence using single sign-on. This setup simplifies how you manage user names and passwords. You must complete this setup before you create your Oracle Fusion Data Intelligence instances except as indicated in scenarios #5 and #6 that require further setup after you create the Oracle Fusion Data Intelligence instance.
Topics:
- About Setting Up User Access to Oracle Fusion Data Intelligence Using Single Sign-On
- Set Up User Access to Oracle Fusion Data Intelligence Using Single Sign-On in Scenario #1
- Set Up User Access to Oracle Fusion Data Intelligence Using Single Sign-On in Scenario #2
- Set Up User Access to Oracle Fusion Data Intelligence Using Single Sign-On in Scenario #3
- Set Up User Access to Oracle Fusion Data Intelligence Using Single Sign-On in Scenario #4
- Set Up User Access to Oracle Fusion Data Intelligence Using Single Sign-On in Scenario #5
- Set Up User Access to Oracle Fusion Data Intelligence Using Single Sign-On in Scenario #6
About Setting Up User Access to Oracle Fusion Data Intelligence Using Single Sign-On
Using single sign-on simplifies managing user access to Oracle Fusion Data Intelligence.
Users of Oracle Fusion Data Intelligence are mostly Oracle Fusion Cloud Applications users and those whom you create specifically in Oracle Fusion Data Intelligence. Setting up access to Oracle Fusion Data Intelligence for these users using single sign-on depends on whether identity domains are available in your cloud account or you're using Oracle Identity Cloud Service to manage the users.
Some Oracle Cloud regions use the Oracle Cloud Infrastructure Identity and Access Management (IAM) identity domains. See Identity Domain Overview. It's easy to determine whether or not your cloud account offers identity domains. In Oracle Cloud Infrastructure Console, navigate to Identity & Security. Under Identity, check for Domains.
The way you set up user access to Oracle Fusion Data Intelligence using single sign-on is based on when you created the cloud account for Oracle Fusion Cloud Applications and the cloud account in which you activated Oracle Fusion Data Intelligence.
- Scenario 1 - Existing Oracle Fusion Cloud Applications in a cloud account that doesn’t offer identity domains and Oracle Fusion Data Intelligence activated in the same cloud account as Oracle Fusion Cloud Applications.
- Scenario 2 - New Oracle Fusion Cloud Applications in a cloud account that offers identity domains and Oracle Fusion Data Intelligence activated in the same cloud account as Oracle Fusion Cloud Applications.
- Scenario 3 - Existing Oracle Fusion Cloud Applications in a cloud account that doesn’t offer identity domains and Oracle Fusion Data Intelligence activated in a different pre-existing cloud account that doesn’t offer identity domains.
- Scenario 4 - New Oracle Fusion Cloud Applications in a cloud account that offers identity domains and Oracle Fusion Data Intelligence activated in a different pre-existing cloud account that doesn’t offer identity domains.
- Scenario 5 - Existing Oracle Fusion Cloud Applications in a cloud account that doesn’t offer identity domains and Oracle Fusion Data Intelligence activated in a different new cloud account that offers identity domains.
- Scenario 6 - New Oracle Fusion Cloud Applications in a cloud account that offers identity domains and Oracle Fusion Data Intelligence activated in a different new cloud account that offers identity domains.
Set Up User Access to Oracle Fusion Data Intelligence Using Single Sign-On in Scenario #1
Scenario #1 applies to a single cloud account for Oracle Fusion Cloud Applications and Oracle Fusion Data Intelligence and the cloud account doesn't offer identity domains.
If you’re an existing user of Oracle Fusion Cloud Applications with Oracle Fusion Data Intelligence activated in the same cloud account as Oracle Fusion Cloud Applications and your cloud account doesn’t offer identity domains, then perform these steps:
Set Up Provisioning with Single Sign-On
Provisioning Oracle Fusion Data Intelligence with single sign-on enables you to synchronize users and groups in Oracle Fusion Cloud Applications with Oracle Identity Cloud Service and then enable these users to access Oracle Fusion Data Intelligence.
Here's the list of tasks that you must complete in the order that they are listed.
- Ensure that you’ve the FA_GSI_Administrator role for the applicable Oracle Fusion Cloud Applications environment. You need this role to synchronize users and groups in Oracle Fusion Cloud Applications with the Oracle Identity Cloud Service instance specified in the Identity Cloud account associated with your Oracle Fusion Cloud Applications instance. See How to add FA_GSI_Administrator role to a user?
- Write down the Oracle Identity Cloud Service details in the mail notifying you of the Identity Cloud account associated with your Oracle Fusion Cloud Applications instance for later use.
- Set up synchronization of Oracle Fusion Cloud Applications with the Oracle Identity Cloud Service instance specified in the Identity Cloud account associated with your Oracle Fusion Cloud Applications instance.
- Federate the Oracle Identity Cloud Service instance specified in the Identity Cloud account associated with your Oracle Fusion Cloud Applications instance to the Oracle Cloud Infrastructure tenancy where Fusion Data Intelligence is provisioned.
- Sign in to the Oracle Cloud Infrastructure tenancy where Fusion Data Intelligence is provisioned using the federated Oracle Identity Cloud Service instance.
Copy and Store the Oracle Identity Cloud Service URL
Copy and store the Oracle Identity Cloud Service URL available in the mail notifying you of the Identity Cloud account associated with your Oracle Fusion Cloud Applications instance in a text file. You require this information while setting up the synchronization of Oracle Fusion Cloud Applications with the Oracle Identity Cloud Service instance.
- From the email, copy the Oracle Identity Cloud Service URL for each of the development and production instances for each of the Oracle Fusion Cloud Applications environments and paste them in a text file.
- If the email isn’t available, then you can raise a service request to obtain information about the Identity Cloud account associated with your Oracle Fusion Cloud Applications instances. See Contact My Oracle Support. Alternatively, as the Oracle Cloud account administrator, access the My Services Dashboard to obtain this information; see About My Services Dashboard.
Set Up Synchronization of Oracle Fusion Cloud Applications with Oracle Identity Cloud Service
Set up the synchronization of Oracle Fusion Cloud Applications with the Oracle Identity Cloud Service instance specified in the Identity Cloud account associated with your Oracle Fusion Cloud Applications instance. This synchronization gets the Oracle Fusion Cloud Applications users and groups into the applicable Oracle Identity Cloud Service instance that enables these users to access Oracle Fusion Data Intelligence.
Federate the Oracle Identity Cloud Service Instance to Your Oracle Cloud Infrastructure Tenancy
Federate the Oracle Identity Cloud Service associated with your Oracle Fusion Cloud Applications instance to the Oracle Cloud Infrastructure tenancy where Oracle Fusion Data Intelligence is provisioned to connect them and enable the usage of a single set of sign-in credentials.
- Sign in to your Oracle Cloud account that contains the tenancy where Oracle Fusion Data Intelligence is provisioned (in certain cases this can be same as your Oracle Fusion Cloud Applications account).
- On the Oracle Cloud Home, navigate to Identity and then click Federation.
- On the Federation page, click Add Identity Provider.
- On the Add Identity Provider page, use lower case to enter a Name and add a description.
- Select Oracle Identity Cloud Service, and enter the URL, client ID, and client secret that you had previously saved in a text file.
- Scroll down and click Continue at the bottom of the Add Identity Provider page.
- In the next page, map IDCS_Administrators under Identity Provider Group to Administrators under OCI Group and click Add Provider.
- On the Federation page, view and write down the name of the new identity provider.
Set Up User Access to Oracle Fusion Data Intelligence Using Single Sign-On in Scenario #2
Scenario #2 applies to a single cloud account for Oracle Fusion Cloud Applications and Oracle Fusion Data Intelligence and the cloud account offers identity domains.
If you’re a new user of Oracle Fusion Cloud Applications with Oracle Fusion Data Intelligence activated in the same cloud account as Oracle Fusion Cloud Applications and your cloud account offers identity domains, then perform these steps:
Set Up User Access to Oracle Fusion Data Intelligence Using Single Sign-On in Scenario #3
Scenario #3 applies to separate cloud accounts for Oracle Fusion Cloud Applications and Oracle Fusion Data Intelligence and both the cloud accounts don't offer identity domains.
If you’re an existing user of Oracle Fusion Cloud Applications in a cloud account that doesn’t offer identity domains with Oracle Fusion Data Intelligence activated in a different existing cloud account that doesn’t offer identity domains, then perform these steps:
Set Up User Access to Oracle Fusion Data Intelligence Using Single Sign-On in Scenario #4
Scenario #4 applies to separate cloud accounts for Oracle Fusion Cloud Applications and Oracle Fusion Data Intelligence with one cloud account offering identity domains and another not offering identity domains.
If you’re a new user of Oracle Fusion Cloud Applications in a cloud account that offers identity domains with Oracle Fusion Data Intelligence activated in a different existing cloud account that doesn’t offer identity domains, then you must federate the identity domain associated with Oracle Fusion Cloud Applications to the Oracle Cloud Infrastructure tenancy where Oracle Fusion Data Intelligence is provisioned. During provisioning of Oracle Fusion Cloud Applications in a cloud account that offers identity domains, typically the Oracle Fusion Cloud Applications users and groups are synchronized automatically with the identity domain. In case the Oracle Fusion Cloud Applications users and groups aren't synchronized automatically with the identity domain, then you must manually enable the synchronization before performing the steps listed in this section. See Synchronize Users from Your Oracle Fusion Cloud Applications Instance with the Identity Domain.
Copy and Store Details of the Identity Domain
Copy and store the client ID, client secret, and the URL of the identity domain associated with the Oracle Fusion Cloud Applications instance in a text file to use while federating the identity domain with the Oracle Cloud Infrastructure tenancy where Oracle Fusion Data Intelligence is provisioned.
- Sign in to the Oracle Cloud Infrastructure Console using the credentials of the cloud account associated with Oracle Fusion Cloud Applications.
- In the Navigator menu, click Identity & Security and on the Identity & Security page, click Domains.
- On the Domains page, click the identity domain associated with the Oracle Fusion Cloud Applications instance.
- On the domain Overview page, in the Domain information section, copy the domain url till identity.oraclecloud.com. For example, in the domain url
https://idcs-12ab34c56789.identity.oraclecloud.com:443
, copyhttps://idcs-12ab34c56789.identity.oraclecloud.com
. - On the domain Overview page, click Oracle Cloud Services and then click Oracle Fusion Cloud Applications.
- On the Oracle Fusion Cloud Applications page, click Configuration.
- Under General Information, copy the Client ID and paste into a text file.
- In Client Secret, click Show Secret, copy the secret, and paste into a text file.
Federate the Identity Domain to Your Oracle Cloud Infrastructure Tenancy
Federate the identity domain associated with your Oracle Fusion Cloud Applications instance to the Oracle Cloud Infrastructure tenancy where Oracle Fusion Data Intelligence is provisioned. This federation enables users to sign in to Oracle Fusion Data Intelligence using their Oracle Fusion Cloud Applications credentials.
- Sign in to your Oracle Cloud account that contains the tenancy where Oracle Fusion Data Intelligence is provisioned.
- On the Oracle Cloud Home, navigate to Identity and then click Federation.
- On the Federation page, click Add Identity Provider.
- On the Add Identity Provider page, enter a name and description.
- Select Oracle Identity Cloud Service as Type.
- Enter the URL of the identity domain, client ID, and client secret that you had saved in a text file. See Copy and Store Details of the Identity Domain.
- Scroll down and click Continue at the bottom of the Add Identity Provider page.
- In the next page, map Domain_Administrators group under Identity Provider Group with Administrators group under OCI Group and click Add Provider.
Set Up User Access to Oracle Fusion Data Intelligence Using Single Sign-On in Scenario #5
Scenario #5 applies to separate cloud accounts for Oracle Fusion Cloud Applications and Oracle Fusion Data Intelligence and one cloud account offers identity domains and another doesn't.
If you’re an existing user of Oracle Fusion Cloud Applications in a cloud account that doesn’t offer identity domains with Oracle Fusion Data Intelligence activated in a different new cloud account that offers identity domains, then perform these steps:
Configure Single Sign-on Between Oracle Identity Cloud Service and Identity Domain
Configure single sign-on between the Oracle Identity Cloud Service instance associated with Oracle Fusion Cloud Applications and the identity domain associated with Oracle Fusion Data Intelligence to ensure that users can sign into Oracle Fusion Data Intelligence with their existing Oracle Fusion Cloud Applications credentials.
To configure single sign-on between the Oracle Identity Cloud Service instance associated with Oracle Fusion Cloud Applications and the identity domain associated with Oracle Fusion Data Intelligence, you must create a Security Assertion Markup Language (SAML) application in Oracle Identity Cloud Service. You then configure this SAML application with the details from the metadata XML file of the Oracle Fusion Data Intelligence identity domain.
Add an SAML Application
Add a Security Assertion Markup Language (SAML) application in the Oracle Identity Cloud Service associated with your Oracle Fusion Cloud Applications instance to provide a way to authenticate a user once and then communicate that authentication to multiple applications.
- Sign in to the Console of Oracle Identity Cloud Service associated with your Oracle Fusion Cloud Applications instance.
- In the Navigator menu, click Applications and on the Applications page, click Add.
- In Add Application, select SAML Application.
- On the Add SAML Application page, in the Details section, enter a name such as FAW-SSO and select the User can request access check box to enable the user to access the app.
- In the SSO Configuration section, click Download Identity Provider Metadata to download the metadata XML file of Oracle Identity Cloud Service associated with your Oracle Fusion Cloud Applications instance and save the metadata XML file to your local machine.
- Save and pause the configuration of this SAML application temporarily to collect certain values from the metadata XML file of the Oracle Fusion Data Intelligence identity domain. Don't sign off from Oracle Identity Cloud Service.
Copy Details from the Identity Domain Metadata File
Copy details from the metadata XML file of the Oracle Fusion Data Intelligence identity domain into a text file to use while configuring the SAML Application that you created.
- Sign in to the Oracle Cloud Infrastructure Console using the credentials of the domain that you created in the cloud account in which you activated Oracle Fusion Data Intelligence.
- In the Oracle Cloud Infrastructure Navigator menu, click Identity & Security and then in the Identity & Security pane, under Identity, click Domains.
- On the Domains page, navigate to the identity domain that you created in this cloud account and on the identity domain details page, click Security and then click Identity Providers.
- On the Identity provider (IdP) policies in the identity domain page, click Add IdP, and select Add SAML IdP from the dropdown list.
- On the Add SAML identity provider page, in the Add Details section, enter Name such as Fusion SSO Login.
- In the Configure IdP section, select the Import identity provider metadata radio button to choose and import the metadata XML file of Oracle Identity Cloud Service associated with your Oracle Fusion Cloud Applications instance that you previously downloaded to your local machine.
- In the Map Attributes section, select Unspecified if the Username for Oracle Identity Cloud Service associated with your Oracle Fusion Cloud Applications instance can be email or short name. If the Username is email, then select EmailAddress.
- In the Export section, download the metadata XML file of the Oracle Fusion Data Intelligence identity domain and its signing certificate.
- Open the metadata XML file of the Oracle Fusion Data Intelligence identity domain in a text editor and copy the values for entityID, AssertionConsumerService, and SingleLogoutService into another text file to use while configuring the SAML Application that you created.
- Return to configuring the SAML Application in the Console of Oracle Identity Cloud Service associated with your Oracle Fusion Cloud Applications instance.
Configure the SAML Application
Use the details from the metadata XML file of the Oracle Fusion Data Intelligence identity domain to configure the SAML Application that you created in the Oracle Identity Cloud Service associated with your Oracle Fusion Cloud Applications instance.
- On the Add SAML Application page, use the metadata XML file of the Oracle Fusion Data Intelligence identity domain and the signing certificate to enter values for Entity ID and Assertion Consumer URL in the General section.
- In Signing Certificate, click Upload to select the signing certificate of the Oracle Fusion Data Intelligence identity domain that you had previously downloaded and upload it.
- In NameID Format, select Unspecified and in NameID Value, select User Name.
- In Advanced Settings section, select the Include Signing Certificate in Signature and Enable Single Logout. Use the metadata XML file of the Oracle Fusion Data Intelligence identity domain and the signing certificate to enter values for Single Logout URL and Logout Response URL.
- Expand the Authentication and Authorization section and ensure that the Enforce Grants as Authorization option isn't selected.
- Click Finish and then click Activate.
- Navigate to the Oracle Fusion Data Intelligence identity domain, click the SAML application that you created to edit it.
- In Edit SAML identity provider, click Test Login to verify that you're able to login successfully.
Set Up User Access to Oracle Fusion Data Intelligence Using Single Sign-On in Scenario #6
Scenario #6 applies to separate cloud accounts for Oracle Fusion Cloud Applications and Oracle Fusion Data Intelligence and both the cloud accounts offer identity domains.
If you’re a new user of Oracle Fusion Cloud Applications in a cloud account that offers identity domains with Oracle Fusion Data Intelligence activated in a different new cloud account that offers identity domains, then perform these steps:
Configure Single Sign-on Between Two Identity Domains
Configure single sign-on between the the identity domain associated with Oracle Fusion Cloud Applications and the identity domain associated with Oracle Fusion Data Intelligence to ensure that users can sign into Oracle Fusion Data Intelligence with their existing Oracle Fusion Cloud Applications credentials.
To configure single sign-on between the identity domain associated with Oracle Fusion Cloud Applications and the identity domain associated with Oracle Fusion Data Intelligence, you must create a Security Assertion Markup Language (SAML) application using the Oracle Cloud Infrastructure Console. You then configure this SAML application with the details from the metadata XML file of the Oracle Fusion Data Intelligence identity domain.
Add an SAML Application
Add a Security Assertion Markup Language (SAML) application in the identity domain associated with your Oracle Fusion Cloud Applications instance to provide a way to authenticate a user once and then communicate that authentication to multiple applications.
- Sign in to the Oracle Cloud Infrastructure Console using the credentials of the cloud account associated with Oracle Fusion Cloud Applications.
- In the Navigator menu, click Applications and on the Applications page, click Add.
- In Add Application, select SAML Application.
- On the Add SAML Application page, in the Details section, enter a name such as FAW-SSO and select the User can request access check box to enable the user to access the app.
- In the SSO Configuration section, click Download Identity Provider Metadata to download the metadata XML file of the identity domain associated with your Oracle Fusion Cloud Applications instance and save the metadata XML file to your local machine.
- Save and pause the configuration of this SAML application temporarily to collect certain values from the metadata XML file of the Oracle Fusion Data Intelligence identity domain.
Copy Details from the Identity Domain Metadata File
Copy details from the metadata XML file of the Oracle Fusion Data Intelligence identity domain into a text file to use while configuring the SAML Application that you created.
- Sign in to the Oracle Cloud Infrastructure Console using your Oracle Fusion Data Intelligence service administrator credentials.
- In the Oracle Cloud Infrastructure Navigator menu, click Identity & Security and then in the Identity & Security pane, under Identity, click Domains.
- On the Domains page, navigate to the identity domain that you created in this cloud account and on the identity domain details page, click Security and then click Identity Providers.
- On the Identity provider (IdP) policies in the identity domain page, click Add IdP, and select Add SAML IdP from the dropdown list.
- On the Add SAML identity provider page, in the Add Details section, enter Name such as Fusion SSO Login.
- In the Configure IdP section, select the Import identity provider metadata radio button to choose and import the metadata XML file of the identity domain associated with your Oracle Fusion Cloud Applications instance that you previously downloaded to your local machine.
- In the Map Attributes section, select Unspecified if the Username for the identity domain associated with your Oracle Fusion Cloud Applications instance can be email or short name. If the Username is email, then select EmailAddress.
- In the Export section, download the metadata XML file of the Oracle Fusion Data Intelligence identity domain and its signing certificate.
- Open the metadata XML file of the Oracle Fusion Data Intelligence identity domain in a text editor and copy the values for entityID, AssertionConsumerService, and SingleLogoutService into another text file to use while configuring the SAML Application that you created.
- Return to configuring the SAML Application in the Oracle Cloud Infrastructure Console that you had previously signed into using the credentials of the cloud account associated with Oracle Fusion Cloud Applications.
Configure the SAML Application
Use the details from the metadata XML file of the Oracle Fusion Data Intelligence identity domain to configure the SAML Application that you created in the identity domain associated with your Oracle Fusion Cloud Applications instance.
- On the Add SAML Application page, use the metadata XML file of the Oracle Fusion Data Intelligence identity domain and the signing certificate to enter values for Entity ID and Assertion Consumer URL in the General section.
- In Signing Certificate, click Upload to select the signing certificate of the Oracle Fusion Data Intelligence identity domain that you had previously downloaded and upload it.
- In NameID Format, select Unspecified and in NameID Value, select User Name.
- In the Advanced Settings section, select the Include Signing Certificate in Signature and Enable Single Logout. Use the metadata XML file of the Oracle Fusion Data Intelligence identity domain and the signing certificate to enter values for Single Logout URL and Logout Response URL.
- Expand the Authentication and Authorization section and ensure that the Enforce Grants as Authorization option isn't selected.
- Click Finish and then click Activate.
- Navigate to the Oracle Fusion Data Intelligence identity domain, click the SAML application that you created to edit it.
- In Edit SAML identity provider, click Test Login to verify that you're able to login successfully.