Box スポークの設定

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：6分

    • 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 の構成

      AI の管理

      Box AI アクションとやり取りする
    10. [変更内容を保存] を選択します。

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

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

    始める前に

    必要なロール：admin

    手順

    1. ServiceNowインスタンスで、 すべて > プロセス自動化 > ワークフロースタジオ.
    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. [接続を設定 (Configure Connection)] をクリックします。

    タスクの結果

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

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

    Box OAuth トークンの再生成

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

    始める前に

    必要なロール：admin

    手順

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

    タスクの結果

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

    ServiceNow インスタンスと JWT ベアラー権限許可タイプとの統合

    JWT ベアラー権限許可タイプで OAuth プロバイダーを設定して、 ServiceNow インスタンスをボックスと統合します。

    始める前に

    必要なロール：admin

    手順

    1. ボックスの端で手順を実行します。
      1. Box 開発者アカウントにサインアップします。
      2. 開発者コンソールで、[カスタムアプリ] を選択します。
      3. 認証方法が JWT (サーバー認証) を使用した OAuth 2.0 であることを確認します。
      4. アプリの一意の名前を入力し、アプリを作成します。
      5. アプリを表示します。
      6. [OAuth 2.0 認証情報] で、[クライアント ID] と [クライアントシークレット] をコピーします。
      7. 新しいキーストアを作成し、そこから公開鍵を BOX にエクスポートします。
      8. アプリ設定の下にある enterpriseID をメモします。
      9. 移動先 自分のアプリ > <アプリ名> > 全般 > 認証のため送信.
      10. 管理コンソールの上部でアカウント名を選択します。
      11. アカウントでフォルダーを作成し、テキストファイルをアップロードします。
    2. ServiceNowインスタンスの最後で手順を実行します。
      1. 移動先 システム定義 > 証明書 > 新規 > タイプ > ストアパス.
      2. キーストア証明書を添付します。
      3. に移動して JWT 署名キーを構成します システム OAuth > JWT キー > 新規.
      4. に移動し、OAuth アプリケーションレジストリエントリを作成します システム OAuth > アプリケーションレジストリー > 新規 > サードパーティ OAuth プロバイダーに接続します > デフォルトの権限許可タイプ (JWT ベアラー).
      5. OAuth エンティティプロファイル (oauth_entity_profile) の下に、作成した「jwt プロバイダー」を関連付けます。
      6. REST メッセージを作成します。
      7. REST メッセージで、[ OAuth トークンの取得 ] を選択してアクセストークンを取得します。
      8. 「Default GET」メソッドに移動し、「Test」をクリックします。
      9. BOX側では、フォルダとファイルを共有します。