Google® Cloud Storageコネクタを使用すると、コマンドをチェーンで使用してGoogle Cloud Storageバケット内のファイルやフォルダを管理できます。
メモ: このコネクターはWorkivaによって構築され、サードパーティのシステムに接続する。Workivaサポートチームは、お客様のワークスペース内でこのコネクターの構成をヘルプすることはできますが、Workivaプラットフォーム外で発生した問題のトラブルシューティングやその他のサポートを行うことはできません。
前提条件
接続を有効にするには、コネクターはGoogle Cloud Storage JSON API を使用します。 コネクターの設定には、以下のものが必要だ:
- コネクター専用のGoogle Cloudアプリケーション
- デフォルトのGoogle Cloud Storageバケット
接続を保護するために、アプリケーションは認証に OAuth consent または Application Default Credentials (ADC) を使用できます。認証方法によっては、以下も必要となる:
- OAuthに同意する場合、アプリケーションのクライアントIDとシークレット
- CloudRunner を備えた ADC の場合、アプリケーション専用のサービスアカウントとその
application_default_credentials.json 認証情報ファイル 注: Google Compute Engine,Google Kubernetes Engine (GKE),App Engine,Cloud Run, またはCloud Functionsの場合、コネクターはアプリのデフォルトサービスアカウントを通じて認証できます。
注: 組織のチェーンでコネクターを使用できるようにするには、まず最初に組織のセキュリティ管理者が構成から コネクターを有効にする必要があります。
Google Cloudアプリケーションの作成
コネクターを設定するには、まずコネクター専用のGoogle Cloudアプリケーションを作成します。アプリケーションに接続するために、コネクターはGoogle Cloud ADCまたはOAuth consentを使用する。
ステップ1.プロジェクトの選択または作成
Google Cloud Platform(GCP)コンソール で、コネクターで使用するプロジェクトを選択または作成します。プロジェクトを作成する:
- ツールバーで、プロジェクトまたは現在のプロジェクト名称を選択し、新規プロジェクトをクリックします。
- プロジェクト名 に、統合を識別するための一意の名称を入力します。
- Location で、あなたの組織を選択し、他の人がプロジェクトを使用できるようにします。
-
作成をクリックします。
ステップ 2.サービスアクセスを有効にする
-
API & Servicesから、Libraryを選択します。
-
Cloud Storageを検索して選択し、Enableをクリックします。
ステップ3.アプリの認証情報を作成または取得する。
アプリケーションを認証するには、Google Cloud ADC または OAuth consent の認証情報を作成し、取得します。
Google Cloudアプリケーションデフォルト認証情報(ADC)
アプリケーションが Compute Engine、Kubernetes Engine、App Engine、Cloud Run、Cloud Functions などの Google Cloud 環境で実行されている場合は、そのデフォルトのサービスアカウントを認証に使用できます。そうでない場合は、サービスアカウントを作成し、認証のためにその資格情報ファイルをダウンロードする:
-
Google Cloud Platform (GCP) コンソール で、Create service account key を開きます。
- サービスアカウント で、新規サービスアカウントを選択する。
- サービスアカウントを識別するための一意の名称を入力します。
- 役割 で、クラウドストレージ、ストレージオブジェクト管理者を選択します。
- キータイプ の下で、JSON を選択する。
-
作成をクリックします。サービスアカウントの
application_default_credentials.jsonファイルをダウンロードします。コネクターの設定時に、このファイルをリソースとしてアップロードします。
OAuth同意
OAuth同意を使用してアプリケーションを認証する:
- API & Servicesから、OAuth 同意画面 を選択します。
-
OAuth同意画面 タブで、内部 を選択し、作成 をクリックする。
- アプリ情報 で、コネクターの認証時にアプリを識別するヘルプとして、アプリの名称とユーザーサポートメールアドレスを入力します。
-
App domain の下に、
wdesk.comの認証ドメインを追加します。 - Developer contact informationの下で、プロジェクトに関するアップデートをGoogleに送信するメールアドレスを入力し、Save and Continueをクリックします。
-
スコープ およびオプション情報 の下で、保存して続行 をクリックし、スコープやオプション情報を追加しない。
メモ: 内部ユーザーを持つアプリケーションでは、スコープやオプション情報は必要ありません。
- 概要 の下で、必要に応じてOAuth同意画面の詳細をレビュー・編集し、ダッシュボードに戻る をクリックする。
-
Credentials タブで、Create credentials をクリックし、OAuth クライアント ID を選択する。
-
アプリケーションタイプ で、ウェブアプリケーションを選択する。
- OAuth 認証情報を識別するための一意の名称を入力します。
-
作成者のJavaScriptの原点の下:
- 北米では
https://h.app.wdesk.comを追加。 - 欧州連合では
https://h.eu.wdesk.comを追加。
- 北米では
-
リダイレクトURI作成者 の下:
- 北米では
https://h.app.wdesk.com/s/wdata/oc/app/oauth/callbackを追加。 - 欧州連合では
https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callbackを追加。
- 北米では
- Create をクリックし、クライアントIDとシークレットをメモする。
アプリケーションデフォルトの認証情報を使用してGoogle Cloud Storageコネクタを設定します。
- チェーンビルダー から接続 をクリックし、右上の作成 をクリックします。
-
コネクター 接続 で、Google Cloud Storage と、コネクターで使用するランナーを選択します。
- 基本情報の下に、コマンドの識別をヘルプするユニークな名称と説明を入力します。
- 認証種別で、Standardを選択します。
- アプリケーションのクレデンシャルファイルで認証する:
- リソース で、コネクターの Google Web アプリケーションの資格情報ファイルをアップロードします。
-
Authentication の下に、
application_default_credentials.jsonのように、資格情報ファイルの名称を入力する。
メモ: デフォルトのサービスアカウントを使用して認証するには、リソース および認証 を空白のままにする。
- プロパティ で、コマンドで指定されていない場合は、コネクターで使用するデフォルトの Cloud Storage バケットを入力します。
- 接続に使用する環境を選択し、保存します。
- 接続をテストするには、コネクターのList Objects コマンドでチェーン を作成して実行し、有効な出力を返すことを確認する。
OAuth同意によるGoogle Cloud Storageコネクターの設定
- チェーンビルダー から接続 をクリックし、右上の作成 をクリックします。
-
コネクター 接続 で、Google Cloud Storage とデフォルトの CloudRunner を選択します。
- 基本情報の下に、コマンドの識別をヘルプするユニークな名称と説明を入力します。
- 認証タイプ で、OAuth 2.0 を選択します。
-
OAuth で、コネクターのGoogleウェブアプリケーションのクライアントIDとシークレットを入力します。
注:機密性の高い資格情報はすべて自動的に暗号化され、高度な暗号化標準(AES)-256暗号化で保存されます。
-
Connectをクリックし、コネクターがGoogleアカウントに使用することを承認します。
メモ: Googleがコネクターを使用することを承認できるようにするには、ブラウザのポップアップを有効にします。
- プロパティ で、コマンドで指定されていない場合は、コネクターで使用するデフォルトの Cloud Storage バケットを入力します。
- 接続に使用する環境を選択し、保存します。
- 接続をテストするには、コネクターのList Objects コマンドでチェーン を作成して実行し、有効な出力を返すことを確認する。
トラブルシューティング
Google Cloud Storageへの接続に失敗した場合:
- Googleウェブアプリケーションの認証ファイルまたはOAuth認証情報を確認します。
- アプリケーションのJavascriptの作成者を確認します:
- 北米では
https://h.app.wdesk.comを追加。 - 欧州連合では
https://h.eu.wdesk.comを追加。
- 北米では
- アプリケーションのリダイレクトURIを確認する:
-
- 北米では
https://h.app.wdesk.com/s/wdata/oc/app/oauth/callbackを追加。 - 欧州連合では
https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callbackを追加。
- 北米では
-
- ウェブアプリケーションがGoogle Cloud Storage APIに使用できることを確認します。