Find your tenant details
Your tenant details identify your Oracle Clinical One environment and the Oracle Life Sciences IAMS service that issues its access tokens.
Find your tenant name
Your Tenant Name is the full tenant name in the host URL your organization uses for Oracle Clinical One.
- Format:
https://{tenant}.clinicalone.oraclecloud.com/eclinical-portal/ - Example: if your URL is
https://acmepharma.clinicalone.oraclecloud.com/eclinical-portal/, your tenant name isacmepharma - If you don’t have this URL, ask your Oracle project manager.
- Copy the Tenant Name across.
Get your token URL
Ask your Oracle project manager for the Oracle Life Sciences IAMS URL that issues access tokens. It is different from the URL you use to make Oracle Clinical One API calls.
- Format:
https://{token host}/ms_oauth/oauth2/endpoints/{tenant ID}/tokens - Example: if your token URL is
https://login.example.oraclecloud.com/ms_oauth/oauth2/endpoints/hsgb/tokens, your token host islogin.example.oraclecloud.comand your tenant ID ishsgb - Copy the IAMS Token Host across, with no protocol and no
/ms_oauthpath. - Copy the Tenant ID across. It is the abbreviated tenant name, while Oracle Clinical One API calls use the full tenant name.
Assign the system administrator role
The role is not assigned by default, and you only need to request it once.
Request the system-admin role
Sign in to Oracle Life Sciences IAMS as a customer-delegated administrator, using the URL specific to your organization.
- Find the URL in your browser bookmarks or in the welcome email Oracle sent when your account was created. See Oracle Life Sciences IAMS bookmarks.
- Under the Administration section, click Users.
- Under the Search Users section, search for your own user.
- In the Search Results table, click your user name.
- On the User Details page, select the Roles tab.
- From the Actions drop-down, select Request.
- Search the roles for
system-admin. - Click Add to Cart.
- In the upper-right, click Checkout.
Create a client ID and secret
Request a Client Credentials client in the OAuth Admin Console.
Request a new client
Sign in to your Oracle Life Sciences IAMS OAuth Admin Console account with your customer-delegated administrator credentials.
- The OAuth Admin Console URL is different from the Oracle Life Sciences IAMS URL. Get it from your Oracle project manager.
- On the home page, click Request New Client.
- Client Name:
StackOne Integration - Client Type: Client Credentials
Add permissions
Each permission gives access to one Oracle Clinical One API category, and you can refine them later.
- Click Add Permissions.
- In the Add permissions dialog, select each permission listed.
- Click Add.
Save the client ID and secret
The generated client ID and secret are displayed on the Request New Client dialog.
- Copy the Client ID across.
- Copy the Client Secret across.
Create the integration user
A Client Credentials client needs a matching user account in Oracle Life Sciences IAMS and in Oracle Clinical One.
Create the user in Oracle Life Sciences IAMS
In Oracle Life Sciences IAMS, create an Oracle Life Sciences single sign-on for the integration.
- User Login: the tenant ID and the full client ID in dot notation,
{tenant ID}.{client ID} - Last name: include the external data source,
{lastName}_{externalDataSource} - Example: a user login of
hsgb.{client ID}and a full name ofJohn Doe_Source
Assign the clinicalone-CNE role
Assign the new user the clinicalone-CNE role. See Assign roles in Oracle Life Sciences IAMS.
Add the user to your studies
In Oracle Clinical One, create the same user at a study level and assign the appropriate study role in each study mode. See Add a user to a study in Oracle Clinical One Platform.
- A global user manager or a user administrator must do this.
- Make sure each study role has the Oracle Clinical One permissions for the tasks StackOne will perform.
Link the Account
Connect
- Click Connect.
- If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
- Once authorization is successful, you will see a confirmation popup.
Use Actions