Box スポークの設定

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

始める前に

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

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

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

始める前に

Box の要件：

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

このタスクについて

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

手順

1. Box 開発者コンソールにログインします。
2. [新しいアプリを作成 (Create new app)] を選択します。
   
3. [カスタムアプリ (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 要求を認証します。

始める前に

必要なロール：アドミン

手順

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

     

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

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

   

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 のインスタンス名に置き換えます。

   

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

タスクの結果

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

注:

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

Box OAuth トークンの再生成

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

始める前に

必要なロール：アドミン

手順

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

タスクの結果

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

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

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

始める前に

必要なロール：アドミン

手順

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側で、フォルダとファイルを共有します。