Product documentation Docs
    • English
    • Deutsch
    • 日本語
    • 한국어
    • Français
  • More Sites
    • Now Community
    • Developer Site
    • Knowledge Base
    • Product Information
    • ServiceNow.com
    • Training
    • Customer Success Center
    • ServiceNow Support Videos
  • Log in

Product documentation

  • Home
How search works:
  • Punctuation and capital letters are ignored
  • Special characters like underscores (_) are removed
  • Known synonyms are applied
  • The most relevant topics (based on weighting and matching to search terms) are listed first in search results
Topics are ranked in search results by how closely they match your search terms
  • A match on the entire phrase you typed
  • A match on part of the phrase you typed
  • A match on ALL of the terms in the phrase you typed
  • A match on ANY of the terms in the phrase you typed

Note: Matches in titles are always highly ranked.

  • Release version
    Table of Contents
    • Software Asset Management
Table of Contents
Choose your release version
    Home Orlando Software Asset Management Software Asset Management Software Asset Management SaaS License Management Integrate with SaaS applications Create a Box integration profile

    Create a Box integration profile

    • Save as PDF Selected topic Topic & subtopics All topics in contents
    • Unsubscribe Log in to subscribe to topics and get notified when content changes.
    • Share this page

    Create a Box integration profile

    Create an integration profile to track software subscriptions and optimize stale licenses for the Box service.

    Before you begin

    The Box account you use to connect the integration requires the following user access permissions.
    Table 1. Edit User Access permissions
    Permission Value
    Shared contacts Allow this user to see all managed users.
    Enable Box Sync Allow this user to synchronize files between Box and the user's desktop.
    Co-Admin User is granted the following administrative privileges.
    Users and Groups
    • Manage users
    • Manage groups
    Files and Folders
    • View users' content
    • Edit users' content
    • Log in to users' accounts
    Reports and Settings
    • View settings and apps for your company
    • Edit settings and apps for your company
    • Run new reports and access existing reports
    These permissions enable the integration to get a list of users, get user activity, and reclaim unused subscriptions.

    Role required: sam_integrator or admin

    About this task

    For additional information on the Box service, see the Box Community.

    Procedure

    1. Create an application on the Box Platform.
      1. Navigate to the Box Developer Console and sign in to your account.
      2. On the My Apps page, click Create New App.
      3. Select Custom App.
      4. On the Authentication Method page, select Standard OAuth 2.0 (User Authentication).
      5. Enter an application name, and then click Create App.
      6. On the Configuration page, obtain the Client ID and Client Secret. You will need to copy and paste these values into your ServiceNow instance in the following steps.
        Note:

        Your client ID and client secret are sensitive. Do not share them.

      7. Enter https://instance.service-now.com/oauth_redirect.do as the Redirect URI, where instance is the name of your ServiceNow instance.
      8. Select the following application scope check boxes:
        • Read all files and folders stored in Box
        • Read and write all files and folders stored in Box
        • Manage users
        • Manage enterprise properties

        These scopes enable the integration to get a list of users, get user activity, and reclaim unused subscriptions.

      9. Click Save Changes.
    2. Return to your ServiceNow instance and create an integration profile.
      1. Navigate to SaaS License > Administration > Create New Profile and select the integration profile you want to create.
      2. On the form, fill in the fields.
        Table 2. Integration profile record form
        Field Value
        Display name Name of the integration profile.
        Client Id Client ID for the OAuth application created in the SaaS admin account.
        Redirect url URL of the OAuth provider that you're redirected to after authentication. This value is automatically populated.
        Client secret Password associated with the client ID.
        Profile type Type of integration profile. This value is automatically populated.
        Analyze user activity from You can choose to start analyzing data from the current date or from up to 60 days in the past. Choosing a date in the past enables you to detect stale subscriptions without waiting in real time because you can see subscriptions that haven't been used recently. Because choosing a date in the past increases the amount of data that is analyzed, it could take several hours for you to be able to view the results.
      3. Click Submit.
    3. On the integration profile, click the Get OAuth Token related link.
    4. In the pop-up window, select your Box admin account and click Allow.
      Note: When user subscriptions are reclaimed, files from the reclaimed accounts are transferred to the admin account selected in this step. This account can be a different admin account than the one used to set up the integration. If you need to start transferring files to a new admin, you can click the Get OAuth Token related link again at any time to select a different admin account. After selecting a new admin, you can reclaim the old admin account to transfer all of their files to the new admin, including all previously reclaimed user files.

    What to do next

    Software models, reclamation rules, user subscriptions, and stale user reclamation candidates are created automatically after the integration is connected and are refreshed daily.

    It's important that you review all automatically generated reclamation rules to ensure that they meet your specifications for reclaiming user subscriptions. For more information, see Review a software reclamation rule.

    Create software entitlements for the automatically generated software models to track software used against software owned. For more information, see Record software rights and user allocations.

    Tags:

    Feedback
    On this page

    Previous topic

    Next topic

    • Contact Us
    • Careers
    • Terms of Use
    • Privacy Statement
    • Sitemap
    • © ServiceNow. All rights reserved.

    Release version
    Choose your release version

      Create a Box integration profile

      • Save as PDF Selected topic Topic & subtopics All topics in contents
      • Unsubscribe Log in to subscribe to topics and get notified when content changes.
      • Share this page

      Create a Box integration profile

      Create an integration profile to track software subscriptions and optimize stale licenses for the Box service.

      Before you begin

      The Box account you use to connect the integration requires the following user access permissions.
      Table 1. Edit User Access permissions
      Permission Value
      Shared contacts Allow this user to see all managed users.
      Enable Box Sync Allow this user to synchronize files between Box and the user's desktop.
      Co-Admin User is granted the following administrative privileges.
      Users and Groups
      • Manage users
      • Manage groups
      Files and Folders
      • View users' content
      • Edit users' content
      • Log in to users' accounts
      Reports and Settings
      • View settings and apps for your company
      • Edit settings and apps for your company
      • Run new reports and access existing reports
      These permissions enable the integration to get a list of users, get user activity, and reclaim unused subscriptions.

      Role required: sam_integrator or admin

      About this task

      For additional information on the Box service, see the Box Community.

      Procedure

      1. Create an application on the Box Platform.
        1. Navigate to the Box Developer Console and sign in to your account.
        2. On the My Apps page, click Create New App.
        3. Select Custom App.
        4. On the Authentication Method page, select Standard OAuth 2.0 (User Authentication).
        5. Enter an application name, and then click Create App.
        6. On the Configuration page, obtain the Client ID and Client Secret. You will need to copy and paste these values into your ServiceNow instance in the following steps.
          Note:

          Your client ID and client secret are sensitive. Do not share them.

        7. Enter https://instance.service-now.com/oauth_redirect.do as the Redirect URI, where instance is the name of your ServiceNow instance.
        8. Select the following application scope check boxes:
          • Read all files and folders stored in Box
          • Read and write all files and folders stored in Box
          • Manage users
          • Manage enterprise properties

          These scopes enable the integration to get a list of users, get user activity, and reclaim unused subscriptions.

        9. Click Save Changes.
      2. Return to your ServiceNow instance and create an integration profile.
        1. Navigate to SaaS License > Administration > Create New Profile and select the integration profile you want to create.
        2. On the form, fill in the fields.
          Table 2. Integration profile record form
          Field Value
          Display name Name of the integration profile.
          Client Id Client ID for the OAuth application created in the SaaS admin account.
          Redirect url URL of the OAuth provider that you're redirected to after authentication. This value is automatically populated.
          Client secret Password associated with the client ID.
          Profile type Type of integration profile. This value is automatically populated.
          Analyze user activity from You can choose to start analyzing data from the current date or from up to 60 days in the past. Choosing a date in the past enables you to detect stale subscriptions without waiting in real time because you can see subscriptions that haven't been used recently. Because choosing a date in the past increases the amount of data that is analyzed, it could take several hours for you to be able to view the results.
        3. Click Submit.
      3. On the integration profile, click the Get OAuth Token related link.
      4. In the pop-up window, select your Box admin account and click Allow.
        Note: When user subscriptions are reclaimed, files from the reclaimed accounts are transferred to the admin account selected in this step. This account can be a different admin account than the one used to set up the integration. If you need to start transferring files to a new admin, you can click the Get OAuth Token related link again at any time to select a different admin account. After selecting a new admin, you can reclaim the old admin account to transfer all of their files to the new admin, including all previously reclaimed user files.

      What to do next

      Software models, reclamation rules, user subscriptions, and stale user reclamation candidates are created automatically after the integration is connected and are refreshed daily.

      It's important that you review all automatically generated reclamation rules to ensure that they meet your specifications for reclaiming user subscriptions. For more information, see Review a software reclamation rule.

      Create software entitlements for the automatically generated software models to track software used against software owned. For more information, see Record software rights and user allocations.

      Tags:

      Feedback

          Share this page

          Got it! Feel free to add a comment
          To share your product suggestions, visit the Idea Portal.
          Please let us know how to improve this content

          Check any that apply

          To share your product suggestions, visit the Idea Portal.
          Confirm

          We were unable to find "Coaching" in Jakarta. Would you like to search instead?

          No Yes
          • Contact Us
          • Careers
          • Terms of Use
          • Privacy Statement
          • Sitemap
          • © ServiceNow. All rights reserved.

          Subscribe Subscribed Unsubscribe Last updated: Tags: January February March April May June July August September October November December No Results Found Versions Search preferences successfully updated My release version successfully updated My release version successfully deleted An error has occurred. Please try again later. You have been unsubscribed from all topics. You are now subscribed to and will receive notifications if any changes are made to this page. You have been unsubscribed from this content Thank you for your feedback. Form temporarily unavailable. Please try again or contact  docfeedback@servicenow.com  to submit your comments. The topic you requested does not exist in the release. You were redirected to a related topic instead. The available release versions for this topic are listed There is no specific version for this documentation. Explore products Click to go to the page. Release notes and upgrades Click to open the dropdown menu. Delete Remove No selected version Reset This field is required You are already subscribed to this topic Attach screenshot The file you uploaded exceeds the allowed file size of 20MB. Please try again with a smaller file. Please complete the reCAPTCHA step to attach a screenshot
          Log in to personalize your search results and subscribe to topics
          No, thanks Login