BlackLine® OAuth2 コネクターを使用すると、チェーンでコマンドを使用して、以下の形でブラックラインと対話することができます：
- ブラックラインからのレポートを一覧表示およびダウンロード
- 以下のものを含む、ブラックライン内のデータをインポートおよび管理：
- アカウント
- 貸借区分
- 為替レート
- サブレジャー
- 法人
- タスク
- ユーザー
メモ: このコネクターはWorkivaによって構築され、サードパーティのシステムに接続する。Workivaサポートチームは、お客様のワークスペース内でこのコネクターの構成をヘルプすることはできますが、Workivaプラットフォーム外で発生した問題のトラブルシューティングやその他のサポートを行うことはできません。
前提条件
コネクターの設定には、以下のものが必要だ：
-
sbus2.api.blackline.comなど、接続するブラックラインインスタンスのホスト名称。 - BlackLine サービスアカウントに設定された統合ユーザーのユーザー名と API キー
メモ： 統合ユーザーには、API 認可の役割と統合権限、およびコネクターが実行するタスクに必要な役割とスコープが必要です。ブラックラインで API キーを作成するには、統合ユーザーの詳細上でユーザー情報の下、API Key向けに作成をクリックします。
- BlackLine APIバージョン2.0のみ対応
- BlackLine 統合チームから提供された、統合ユーザーのクライアント ID と OAuth スコープ
メモ： クライアント ID、クライアントシークレット、スコープが必要な場合は、BlackLine の担当者に連絡してください。
BlackLine OAuth2コネクターの設定
注： 組織のチェーンでコネクターを使用できるようにするには、まず最初に組織のセキュリティ管理者が構成から コネクターを有効にする必要があります。
- チェーンビルダー から接続 をクリックし、右上の作成 をクリックします。
-
Connector Connection で、BlackLine OAuth2 とデフォルトの CloudRunner を選択します。
- 接続を識別するための一意の名称と説明を入力します。
- [プロパティ]で、接続の詳細を入力します。
プロパティ 詳細 ユーザー名 BlackLine統合ユーザーの名称を入力します。 パスワード BlackLine統合ユーザーに生成されたAPIキーを入力します。 注:ブラックラインで API キーを作成するには、統合ユーザーの詳細上でユーザー情報の下、API Key向けに作成をクリックします。これは、ブラックラインオンラインにサインインする際に使用するパスワードではありません。
クライアントID BlackLine 統合チームから提供されたクライアント ID を入力します。 クライアントの秘密 BlackLine 統合チームから提供されたクライアントシークレットを入力します。 スコープ ブラックライン統合チームから提供された統合ユーザーの OAuth スコープを入力します。コネクターはこれらと同じスコープを使用する。 インスタンスホスト名称 https:// なしで、接続するブラックラインインスタンスのホスト名称を入力します。例えば、デフォルトの開発環境の場合、sbus2.api.BlackLine.com。注：機密性の高い資格情報はすべて自動的に暗号化され、高度な暗号化標準（AES）-256暗号化で保存されます。
- 接続を使用する環境を選択して、保存をクリックします。
- 接続をテストするには、チェーン を作成し、BlackLine OAuth2 コネクターの List Reports コマンド で実行し、有効な出力を返すことを確認します。
トラブルシューティング
BlackLineへの接続に失敗した場合：
- BlackLine 統合チームから提供されたクライアント認証情報と OAuth スコープを確認します。OAuthスコープ、クライアントIDまたはシークレットが必要な場合は、BlackLineの担当者に連絡してください。
- 統合ユーザーのユーザー名とAPIキーが正しいことを確認してください。
メモ: 統合ユーザーの API キーは期限切れになる場合があります。ブラックラインで API キーを更新するには、統合ユーザーの詳細上でユーザー情報の下、API Key向けに作成をクリックします。
- 統合ユーザーが、接続コマンドに関連するタスクを実行するための API 権限と適切な役割とスコープを持っていることを確認します。
- コネクターに正しい BlackLine インスタンス・ホスト名称が入力されていることを確認します。