Set up the Confluence Cloud spoke
Integrate the ServiceNow instance and Confluence Cloud by creating a custom OAuth 2.0 application in Confluence Cloud to authenticate ServiceNow requests.
Avant de commencer
- Request an Integration Hub subscription.
- Activate the Confluence Cloud spoke.
- Atlassian role required: site admin
- Role required: admin.
Create a Confluence Cloud OAuth 2.0 (3LO) application
Create a Confluence Cloud OAuth 2.0 (3LO) application to enable access to the Confluence Cloud API.
Avant de commencer
Role required: Atlassian site admin.
Procédure
- From a web browser, open the Atlassian Developer portal.
- Log in to your site admin account.
-
On the page header of the portal, click your profile icon and then select
Developer console.
The My apps page of the Atlassian Developer Console opens.
-
Click the Create app menu and then select
OAuth 2.0 (3LO) integration.
The Create a new OAuth 2.0 (3LO) integration page opens.
- Enter a name for the OAuth 2.0 (3LO) application in the Name field.
-
Select the I agree to be bound by Atlassian's developer
terms check box and then click
Create.
The overview and settings for your newly created app open.
-
Configure authorization settings for your application.
- From the left navigation pane, select Authorization.
-
Click Configure for the OAuth 2.0 (3LO)
authorization type.
The OAuth 2.0 authorization code grants (3LO) for apps page opens.
-
In the Callback URL field, enter the URL of the
OAuth provider that users are redirected to after authentication.
Enter https://instance.service-now.com/oauth_redirect.do, where <instance> is the name of your ServiceNow instance.
- Click Save changes.
-
Configure API scopes for your application.
API scopes specify the level of access that the application has to the Atlassian APIs.
- From the left navigation pane, select Permissions.
-
From the list of available APIs, locate the Confluence API and then
click Add.
The Add action button automatically changes to the Configure action button.
-
Click Configure.
The Confluence API page opens.
-
Add the following scopes for the Confluence API:
- Search Confluence content and space summaries
- Read user groups
- Create, remove and update user groups
- Read user
-
Retrieve the client ID and client secret that are assigned to your
application.
- From the left navigation pane, select Settings.
-
In the Authentication details section, copy the values in the
Client ID and Secret
fields.
Save them in a secure location for later use.
Create a Confluence Cloud connection
Create a connection between your Confluence Cloud applications and your ServiceNow instance.
Avant de commencer
Role required: admin
Procédure
-
From your ServiceNow instance, navigate to Process Automation > Flow Designer.
The Flow Designer launches in a new tab.
- Select the Connections tab.
- Click View Details for your Confluence Cloud connection.
-
From the list of available connections, locate Confluence Cloud
and then click Configure.
The Configure Connection dialog box opens.
-
In the dialog box, fill in the fields.
Tableau 1. Configure Connection dialog box Field Description Connection Information Connection Name Name of the Confluence Cloud connection. This field populates automatically. Credential Information Name Name of your Confluence Cloud credentials. This field populates automatically. Site URL Remarque :This field appears only if you have requested and installed version 1.0.2 or earlier of the Confluence Cloud spoke.URL of your Confluence Cloud site. Connection URL Remarque :This field appears only if you have requested and installed version 1.0.3 or later of the Confluence Cloud spoke.API URL for Confluence Cloud. This field is automatically set to https://api.atlassian.com. OAuth Client ID Client ID that is assigned to your Confluence Cloud OAuth 2.0 (3LO) application. OAuth Client Secret Client secret that is assigned to your Confluence Cloud OAuth 2.0 (3LO) application. OAuth Redirect URL URL of the OAuth provider that users are redirected to after authentication. This field populates automatically based on the callback URL that you specified in Create a Confluence Cloud OAuth 2.0 (3LO) application. -
Click Configure and Get OAuth Token.
The Authorize App dialog box opens.
-
In the dialog box, click Allow.
The OAuth token becomes available for authorizing your Confluence Cloud connection.
Add Confluence groups
Specify the groups that have access to Confluence products so that you can manage the users within only these groups using the Confluence Cloud spoke.
Avant de commencer
ServiceNow role required: admin
Role required: Atlassian site admin
Procédure
- From a web browser, open the Atlassian Administration portal.
- Log in to your site admin account.
- Navigate to SITE SETTINGS > Product access.
-
In the Confluence section, view the list of groups that have access to
Confluence products.
Take note of this information for later use.
- Return to your ServiceNow instance and navigate to Confluence Cloud > Confluence Groups.
-
On the Confluence Groups form, click the Add Groups
related link.
The Add Confluence Groups dialog box opens.
-
In the Available list, select the groups that have access to Confluence
products.
Conseil :The Available list includes all groups that are associated with your Atlassian account. Select only the groups that have access to Confluence products.
- Click the right arrow button to move the groups from the Available list to the Selected list.
- Click OK.