Box スポークの設定

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間：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インスタンスで、 すべて > プロセスの自動化 > Flow Designer.
    2. [接続] タブを選択します。
    3. [Box] 接続エイリアスを検索します。
    4. [詳細を表示] を選択します。
    5. 接続を構成します。
      1. 接続を追加、または編集します。

        • 既存の接続を設定するには、[構成] または [編集] を選択します。

        • 新しい接続を作成して構成するには、[接続を追加] を選択します。

        注:
        スポークを介した複数接続をサポートするには、「複数接続のサポート」を参照してください。
      2. 構成フォームに入力します。

        フィールド

        値

        接続名

        Box

        接続 URL

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

        認証情報名

        Box Upload Credentials

        OAuth 名

        Box OAuth

        OAuth クライアント ID

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

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

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

        OAuth リダイレクト URL

        この形式の URL： <instance-name>.com/oauth.do
      3. 構成を確認します。
        • 既存の接続の場合、[OAuth トークンを編集して取得 (Edit and Get OAuth Token)] を選択します。
        • 新規接続の場合、[OAuth トークンを構成して取得 (Configure and Get OAuth Token)] を選択します。
        注:
        OAuth トークンは 30 日後に期限が切れます。アドミニストレーターは、30 日ごとにスポーク OAuth トークンを再生成できます。

    Box OAuth トークンの再生成

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

    始める前に

    必要なロール：admin

    手順

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

    タスクの結果

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