Box スポークの設定

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：4分

    • ServiceNow インスタンスと Box API を統合して、Box スポークアクションを自動化します。たとえば、Box アカウントのファイルを削除するフローを設定することができます。Box スポークを設定すると、このフローは自動化されます。

    始める前に

    • 統合ハブ サブスクリプションの要求。
    • ボックススポークを有効にします。
    • Box 開発者コンソールにアクセスします。
    • 必要なロール：admin。

    OAuth アプリケーションの作成

    ボックスアカウントからカスタム OAuth アプリケーションを作成し、ボックススポークで OAuth 2.0 認証を有効にします。

    始める前に

    Box の要件：
    • Box アカウント
    • Box アドミン認証情報
    • 必要なロール：admin

    このタスクについて

    Box アカウントから、次の手順を実行します。カスタムアプリケーションの作成と設定については、Box Developer Portal のドキュメントを参照してください。

    手順

    1. Box 開発者コンソールにログインします。
    2. [新しいアプリを作成 (Create new app)] を選択します。
      [新しいアプリを作成 (Create New App)] ボタンを強調する
    3. [カスタムアプリ (Custom App)] を選択します。
      [カスタムアプリ (Custom App)] オプションを強調する
    4. フォームに入力します。

      フィールド

      値

      アプリ名

      Box アプリ

      説明 (オプション)

      このフィールドは空のままにします。

      目的

      [カスタムポータル (Custom Portal)]を選択
    5. [次へ] を選択します。
      [カスタムアプリを作成 (Create a Custom App)] モーダルが表示されます。
    6. ユーザー認証 (OAuth 2.0) (User Authentication (OAuth 2.0)) を選択します。
    7. 確定するには、[アプリの作成 (Create App)] を選択します。
      アプリケーションの構成設定に入りました。
    8. [OAuth 2.0 認証情報] セクションで、[クライアント ID] と [クライアントシークレット] をコピーします。

      この情報は、ServiceNow インスタンスでサードパーティ OAuth プロバイダーとしてアプリケーションを登録する場合に必要です。

    9. [アプリケーションスコープ] セクションで、サポートする必要があるスコープ権限を有効にします。

      アプリケーションスコープ

      必須項目

      Box に格納されているすべてのファイルとフォルダーの読み取りと書き込み

      ドキュメント管理、ドキュメント共有、およびフォルダー管理アクション

      ユーザーの管理

      ユーザー管理アクション

      グループの管理

      グループ管理アクション

      エンタープライズプロパティの管理

      ドキュメント共有、グループ管理、およびユーザー管理アクション

      Webhook の管理

      V2 Webhook の構成
    10. [変更内容を保存] を選択します。

    Box スポークの接続レコードの構成

    Box 接続を追加して設定し、Box スポークで ServiceNow 要求を認証します。

    始める前に

    必要なロール：admin

    手順

    1. ServiceNowインスタンスで、 All (すべて) > プロセス自動化 > Workflow Studio (ワークフロースタジオ).
    2. [統合] タブをクリックします。
    3. [接続] の項目で、[送信] 接続を切り替えて有効にします。
    4. Box のエイリアスを見つけて、[詳細を表示] をクリックします。
      • Box スポークに付属するデフォルトの接続および資格情報エイリアスレコードを構成するには、[ 詳細を表示] をクリックします。

        Box 接続の詳細を表示します。

      • 複数の Box スポーク接続レコードを管理するには、[ 接続を追加] をクリックして新しい子エイリアスレコードを作成する必要があります。複数の接続の使用の詳細については、「複数接続のサポート」を参照してください。

      スポークを初めて設定する場合は、[設定 (Configure)] をクリックします。それ以外の場合は、[編集] をクリックします。

      Box 接続を構成します。

    5. フォームに、これらの値を入力します。

      フィールド

      値

      接続名

      Box

      接続 URL

      この形式のインスタンス URL：<provider-domain-name>.net

      認証情報名

      Box Upload Credentials

      OAuth 名

      Box OAuth

      OAuth クライアント ID

      アプリケーションのクライアント ID。詳細については、「OAuth アプリケーションの作成」を参照してください。

      OAuth クライアントシークレット

      アプリケーションのクライアントシークレット。詳細については、「OAuth アプリケーションの作成」を参照してください。

      OAuth リダイレクト URL

      次の形式の URL: https://<ServiceNow-instance-name>.service-now.com/oauth_redirect.do。<ServiceNow-instance-name> をServiceNowインスタンス名に置き換えます。

      Box 接続を構成します。

    6. [接続を設定] をクリックします。

    タスクの結果

    スポーク接続が設定され、使用する準備ができました。

    注:
    OAuth トークンは 30 日後に期限が切れます。アドミニストレーターは、30 日ごとにスポーク OAuth トークンを再生成できます。

    Box OAuth トークンの再生成

    ボックス OAuth トークンが期限切れになるときに再生成します。ボックススポーク OAuth トークンは 30 日ごとに期限切れになります。

    始める前に

    必要なロール：admin

    手順

    1. ServiceNowインスタンスで、 All (すべて) > プロセス自動化 > Flow Designer (フローデザイナー).
    2. [Connections (接続)] タブを選択します。
    3. [Box] 接続エイリアスを検索します。
    4. [詳細を表示] を選択します。
    5. 接続の [OAuth トークンの取得] を選択します。

    タスクの結果

    Box スポークは、新しい OAuth アクセストークンを受け取ります。有効期限は 30 日です。