You must register any external application you want to integrate with the Content Innovation Cloud. The following registration procedure applies to both external service applications and external web server applications.
If you are registering an external service application, make sure
a service user is configured before you start this procedure. To create a new service
user, see Creating a Service User.
To register an external application:
- Open the Content Innovation Cloud Administration Portal.
-
Select the External Systems tab under the banner.
The External Applications page is displayed.
-
Click Create External Application.
The Create External Application wizard is displayed.
-
Select an application profile for the external application.
- Select Service Application to register a service application that calls Content Innovation Cloud APIs without an interactive (human) user.
- Select Web Server Application to register a server-based web application that calls Content Innovation Cloud APIs in the context of an interactive user.
-
Click Next Step.
The Application Name page is displayed.
-
Enter a name for the application in the Application Name
field, and then click Next Step.
Depending on the application profile you selected, either the User Mapping page or the Redirect URIs page is displayed.
-
Enter the required information based on the profile you selected.
- If you selected Service Application as the application profile, select a service user from the Mapped Service User drop-down list, and then click Next Step.
- If you selected Web Server Application as the
application profile, configure the redirect URIs.
-
On the Redirect URIs page, enter the URI the user is allowed to be redirected to after signing in successfully.
- To add another URI, click Add Redirect URI, and enter the URI in the new Redirect URI field.
- To remove a URI, click the Delete button displayed to the right of the Redirect URI field.
-
Click Next Step.
-
On the Post Logout Redirect URIs page, enter the URI the user is allowed to be redirected to after logout.
- To add another URI, click Add Post Logout Redirect URI, and enter the URI in the new Post Logout Redirect URI field.
- To remove a URI, click the Delete button located to the right of the Post Logout Redirect URI field.
-
Click Next Step.
-
The Allowed Scopes page is displayed. -
From the Allowed Scopes drop-down list, select the
scopes the external application is allowed to request a grant for.
At least one scope must be assigned to provide access to Content Innovation Cloud APIs. Required scopes vary depending on the resources the external application needs. For information about available scopes, see Scopes for External Applications.
-
If environment_authorization is one of the scopes you
selected, then select the associated environment and subscribed application for
authorization.
-
From the Environment drop-down list, select the
environment this external application should be restricted to.
The Application drop-down list is displayed.
- From the Application drop-down list, select the subscribed application to link to this external application.
-
From the Environment drop-down list, select the
environment this external application should be restricted to.
-
Click Next Step.
The Review page is displayed.
-
Review the settings for the external application.
To return to a previous step, either select the step from the left side of the wizard, or click Previous Step.
-
Click Create External Application to confirm the
settings and register the external application.
The Summary page displays the autogenerated application ID and client secret for the external application.
-
Copy the Application ID and
Secret values to a secure location.
The integrating application requires these values in order to obtain access tokens from the Content Innovation Cloud.
Note: The secret value will not be shown again after the Create External Application wizard is closed. If necessary, you can reset the secret as described under Resetting the Secret for an External Application. - Click Close to return to the External Applications page.