Box スポークの設定

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)] を選択します。
   
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 の構成

10. [変更内容を保存] を選択します。

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

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

始める前に

必要なロール：admin

手順

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. [接続を設定] をクリックします。

タスクの結果

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

注:

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