Set up Dropbox Business spoke

  • 릴리스 버전: Australia
  • 업데이트 날짜 2023년 08월 03일
  • 소요 시간: 14분

    • Set up an outbound integration between a ServiceNow instance and a Dropbox Business application by setting up the connection and credential records.

    시작하기 전에

    • Request an Integration Hub subscription.
    • Activate the Dropbox Business spoke.
    • Role required: admin.

    Setting up the Dropbox Business spoke, includes actions in the Dropbox app console, in the ServiceNow AI Platform® user interface, and in the Workflow Studio. Setup is easier if you keep each of these pages open in separate tabs.

    이 태스크 정보

    You must set up three connection and credential records for Team Management, File Access, and Content alias, in that order. The connection and credential forms contain the OAuth 2.0 credentials needed to establish a connection with the Dropbox business application. Before setting up the form, you must configure the data it needs by setting up an OAuth 2.0 authentication at the Dropbox Business application end. You must also ensure that you've already set up the alias and application registries.

    Set up OAuth 2.0 authentication

    Set up an OAuth 2.0 authentication between the Dropbox Business application and the ServiceNow instance by setting up a custom Dropbox Business application.

    시작하기 전에

    OAuth 2.0 setup requirements:
    • A Dropbox Business account.
    • Role required: team admin.

    이 태스크 정보

    This procedure creates a custom application on the Dropbox Business account. The application provides the OAuth 2.0 credentials necessary to set up the connection and credential records for all three Dropbox Business aliases. For more information on setting up applications, see https://www.dropbox.com/developers/documentation.

    프로시저

    1. Log in to the Dropbox Professional My apps console, https://www.dropbox.com/developers/apps.
    2. Select Create app.
    3. On the Create a new app on the DBX Platform page, do the following actions.Dropbox Business application setup.
      1. Under Choose an API, select Scoped access.
      2. Under Choose the type of access that you need, select the appropriate access type.
      3. Under Name your app, enter a custom name for the application.
      4. Select Create app.
        The custom application is created.
    4. To set up the OAuth 2.0 application, do the following steps under the Settings tab of the custom application.OAuth setup under Dropbox Business application.
      1. Copy and store the value under the App key.
        Use the App key value in the Client ID field of the application registry on the ServiceNow instance.
      2. Select Show under the App secret and then copy and store the value.
        팁:
        You need both the App key and App secret values when you set up the application registries on the ServiceNow instance.
      3. In the Redirect URIs field, enter the ServiceNow instance URL in the format https://instancename/oauth_redirect.do.
        주:
        You can add multiple URIs.
      4. 옵션: To add a redirect URI, select Add and then enter the ServiceNow instance URL.
      5. Select Submit.
      All three connection and credential records for the Dropbox Business application use the same App secret, App key, and Redirect URI that you set up in this step.

    다음에 수행할 작업

    Create Connection and Credential records for the Dropbox Business Team Management alias

    Create Connection and Credential records for the Dropbox Business Team Management alias

    Create connection records to a Dropbox Business account. A connection alias resolves your Dropbox connection and credential at runtime. Only one connection is active per Connection Alias at a time.

    시작하기 전에

    Role required: admin.

    프로시저

    1. Navigate to All > Process Automation > Flow Designer.
    2. Select the Connections tab.
    3. In the Search all connections field, enter Dropbox.
    4. On the DropboxBusinessTeamManagement tile, select View Details.
    5. Select Configure.Configure button for Team Management alias.
    6. In the Configure Connection form, fill the details.
      표 1. Configure connection
      Field Description
      Connection Name Name of the connection between the Dropbox Business application and the ServiceNow instance.
      주:
      The default and read-only name is DropboxBusinessTeamManagement. To provide a custom name, create another connection and credential record.
      Connection URL The URL to connect to the Dropbox Business account. The URL is https://api.dropboxapi.com.
      API Version The version of the API.
      Credential Name The custom name of the credential to access the Dropbox Business account.
      OAuth Entity Name The custom name of the OAuth entity that you created in the Dropbox Business account.
      OAuth Client ID The client ID that you generated in the custom Dropbox Business application. To learn how to generate, see Set up OAuth 2.0 authentication.
      OAuth Client Secret The client secret that you generated in the custom Dropbox Business application. To learn how to generate, see Set up OAuth 2.0 authentication.
      OAuth Redirect URL The redirect URI that you had provided in the Dropbox business application.
    7. Select Configure and Get OAuth Token.
      A temporary OAuth token is generated.

    다음에 수행할 작업

    Create Connection and Credential records for the Dropbox Business File Access alias

    Create Connection and Credential records for the Dropbox Business File Access alias

    Create connection records to a Dropbox Business account for the DropboxBusinessFileAccess alias. Connection aliases resolve your Dropbox connection and credential at runtime. Only one connection is active per Connection Alias at a time.

    시작하기 전에

    Role required: admin.

    프로시저

    1. Navigate to All > Process Automation > Flow Designer.
    2. Select the Connections tab.
    3. In the Search all connections field, enter Dropbox.
    4. On the DropboxBusinessFileAccess tile, select View Details.
    5. Select Configure.Configure button for Dropbox Business Content alias.
    6. In the Configure Connection form, fill the details.
      표 2. Configure connection
      Field Description
      Connection Name Name of the connection between the Dropbox Business application and the ServiceNow instance.
      주:
      The default and read-only name is DropboxBusinessFileAccess. To provide a custom name, create another connection and credential record.
      Connection URL The URL to connect to the Dropbox Business account. The URL is https://api.dropboxapi.com.
      API Version The version of the API.
      Credential Name The custom name of the credential to access the Dropbox Business account.
      OAuth Entity Name The custom name of the OAuth entity that you created in the Dropbox Business account.
      OAuth Client ID The client ID that you generated in the custom Dropbox Business application. To learn how to generate, see Set up OAuth 2.0 authentication.
      OAuth Client Secret The client secret that you generated in the custom Dropbox Business application. To learn how to generate, see Set up OAuth 2.0 authentication.
      OAuth Redirect URL The redirect URI that you had provided in the Dropbox business application.
    7. Select Configure and Get OAuth Token.
      A temporary OAuth token is generated.

    다음에 수행할 작업

    Create Connection and Credential records for the Dropbox Content alias

    Create Connection and Credential records for the Dropbox Content alias

    Create connection records to a Dropbox Business account for the DropboxBusinessContent alias. Connection aliases resolve your Dropbox connection and credential at runtime. Only one connection is active per Connection Alias at a time.

    시작하기 전에

    Role required: admin.

    프로시저

    1. Navigate to All > Process Automation > Flow Designer.
    2. Select the Connections tab.
    3. In the Search all connections field, enter Dropbox.
    4. On the DropboxBusinessContent tile, select View Details.
    5. Select Configure.Configure button for Dropbox Business Content alias.
    6. In the Configure Connection form, fill the details.
      표 3. Configure connection
      Field Description
      Connection Name Name of the connection between the Dropbox Business application and the ServiceNow instance.
      주:
      The default and read-only name is DropboxBusinessContent. To provide a custom name, create another connection and credential record.
      Connection URL The URL to connect to the Dropbox Business account. The URL is https://api.dropboxapi.com.
      API Version The version of the API.
      Credential Name The custom name of the credential to access the Dropbox Business account.
      OAuth Entity Name The custom name of the OAuth entity that you created in the Dropbox Business account.
      OAuth Client ID The client ID that you generated in the custom Dropbox Business application. To learn how to generate, see Set up OAuth 2.0 authentication.
      OAuth Client Secret The client secret that you generated in the custom Dropbox Business application. To learn how to generate, see Set up OAuth 2.0 authentication.
      OAuth Redirect URL The redirect URI that you had provided in the Dropbox business application.
    7. Select Configure and Get OAuth Token.
      A temporary OAuth token is generated.

    결과

    The Dropbox Business spoke is set up and integrated with the ServiceNow instance.