Box スポークの設定

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む3読むのに数分

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

    始める前に

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

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

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

    始める前に

    Box の要件：
    • Box アカウント
    • Box 管理者資格情報
    • 必要なロール：admin

    このタスクについて

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

    手順

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

      フィールド

      値

      アプリ名

      Box アプリ

      説明 (オプション)

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

      目的

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

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

    9. [アプリケーションスコープ] セクションで、サポートするスコープのアクセス許可を有効にします。

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

      必須項目

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

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

      ユーザーの管理

      ユーザー管理アクション

      グループの管理

      グループ管理アクション

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

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

      Webhook を管理

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

    Box スポークの接続の設定

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

    始める前に

    必要なロール：管理者

    手順

    1. ServiceNowインスタンスで、次の場所に移動します。 すべて > プロセス自動化 > フローデザイナー.
    2. [接続] タブを選択します。
    3. Box 接続エイリアスを検索します。
    4. [詳細を表示] を選択します。
    5. 接続を構成します。
      1. 接続を追加または編集します。

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

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

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

        フィールド

        値

        接続名

        ボックス。

        接続 URL

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

        資格情報名

        Box アップロード資格情報。

        OAuth 名

        Box OAuth。

        OAuth クライアント ID

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

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

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

        OAuth リダイレクト URL

        この形式の URL: <instance-name>.com/oauth.do。
      3. 構成を確認します。
        • 既存の接続の場合は、[ OAuth トークンを編集して取得] を選択します。
        • 新しい接続の場合は、[ OAuth トークンの構成と取得] を選択します。
        注:
        OAuth トークンは 30 日後に期限切れになります。管理者は、30 日ごとにスポーク OAuth トークンを再生成できます。

    Box OAuth トークンの再生成

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

    始める前に

    必要なロール：管理者

    手順

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

    タスクの結果

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