Lucid 開発者ツールで OAuth 2.0 アプリケーションを作成して認証し、Lucid アドミンツールで SCIM API を有効にして、 Lucidchart 外部コンテンツコネクタが Lucidchart コンテンツにアクセスできるようにします。
始める前に
アカウントでクロスドメイン ID 管理システム (SCIM) 機能を有効にした、 Lucidchart の Enterprise サブスクリプションが必要です。アカウントで SCIM を有効にする方法の詳細については、 https://lucid.readme.io/reference/overview-scim にある「Lucid SCIM API リファレンス」を参照してください。
Lucid 開発者ツール (https://lucid.app/developer) および Lucid アドミンツール (https://admin.lucid.app/) のアドミン権限が必要です。
Lucidchart 外部コンテンツコネクタを作成するコネクタアドミンには、作成するアプリケーションのアプリケーションコラボレーターロールを自分にアサインできるように、組織の Lucidchart インスタンスにアカウントが必要です。ユーザーのアカウントは、コネクタがクロールまたは取得できるようにするすべての Lucidchart コンテンツにアクセスできる必要があります。
必要なロール:なし
このタスクについて
Lucidchart 外部コンテンツコネクタは、Lucid SCIM API を使用して、Lucidchart ソースシステム内のドキュメントから検索可能なコンテンツを取得します。
コネクタが SCIM API を介して Lucidchart ソースシステムにアクセスできるようにするには、Lucid 開発者ツールで OAuth 2.0 アプリケーションを構成して承認し、Lucid アドミンツールで SCIM ベアラートークンを生成する必要があります。コネクタアドミンは、ソースシステムに適切に接続できるように Lucidchart 外部コネクタを構成するために、OAuth 2.0 アプリケーションのクライアント設定と SCIM ベアラートークンを必要とします。
手順
-
Lucid 開発者ツールを使用して、 Lucidchart 外部コンテンツコネクタ用の新しいアプリケーションを作成します。
-
https://lucid.app/developerに移動し、アドミン認証情報でログインします。
-
[ アプリケーションの作成] を選択します。
-
新しいアプリケーションの名前を入力します。
例として、「 Lucidchart 外部コンテンツコネクタ」と入力します。
-
[Create] を選択します。
新しいアプリケーションの [全般設定] タブが表示されます。
-
コネクタアドミンを招待して、新しいアプリケーションの協力者にします。
注: ServiceNow AI PlatformインスタンスにLucidchart外部コンテンツコネクタを作成するコネクタアドミンは、この手順をスキップできます。アプリケーションの作成者は、 オーナー ロールを持つアプリケーション協力者として自動的に追加されます。
-
[協力者] セクションで、[ 招待] を選択します。
-
[アプリケーション協力者を招待] モーダルウィンドウで、Lucidchart外部コンテンツコネクタを作成するコネクタアドミンのメールアドレスを入力します。
-
招待されたアプリケーション協力者の テスター ロールを選択します。
-
[ 招待] を選択します。
-
アプリケーションコラボレーターとして招待する必要がある追加の コネクタ アドミンごとに、これらの手順を繰り返します。
-
新しいアプリケーションで OAuth 2.0 クライアントを作成します。
-
OAuth 2.0 に移動します。
-
[カスタム OAuth 2.0 クライアントを作成 (Create custom OAuth 2.0 client)] フィールドに、新しい OAuth 2.0 クライアントの名前を入力します。
例として、「Lucidchart 外部コンテンツコネクタ OAuth 2.0 クライアント」と入力します。
-
[ OAuth 2.0 クライアントの作成] を選択します。
新しい OAuth 2.0 クライアントの詳細が表示されます。
-
コピーアイコン
を選択して新しい OAuth 2.0 クライアントの クライアント ID 値をコピーし、その値を安全な場所に記録します。
重要: 外部コンテンツコネクタアドミンは、 Lucidchart 外部コンテンツコネクタを構成するときにこのクライアント ID 値を必要とします。
-
コピーアイコン
を選択して新しい OAuth 2.0 クライアントの クライアントシークレット 値をコピーし、その値を安全な場所に記録します。
重要: 外部コンテンツコネクタアドミンは、 Lucidchart 外部コンテンツコネクタを構成するときにこのクライアントシークレット値を必要とします。
-
[許可されたリダイレクト URI] セクションで、[ リダイレクト URI の追加] を選択します。
-
コールバック URI として https://<instance-name>.service-now.com/oauth_redirect.do と入力し、 <instance-name> を ServiceNow AI Platform® インスタンス名に置き換えて 、[追加] を選択します。
-
Lucid SCIM API への要求を認証するために使用できる SCIM ベアラートークンを生成します。
-
https://admin.lucid.app/に移動し、アドミン認証情報でログインします。
-
移動先 .
-
[有効な統合 (Enabled integrations)] セクションで、SCIM 統合を見つけ、その [設定 ] リンクを選択します。
注: [有効な統合] セクションに SCIM 統合が表示されない場合は、Lucid サポートに連絡して、アカウントで SCIM を有効にするように依頼してください。
[SCIM 統合の設定] 画面が表示されます。
-
[SCIM セットアップ] サブセクションの [IdP 構成] セクションで、[ トークンを生成] を選択します。
注: リンクに [トークンを生成] ではなく [トークンを再生成] と表示されている場合は、アカウントに既に SCIM ベアラートークンが生成されています。次のステップにスキップします。
-
[コピー] アイコン
を選択して ベアラートークン 値をコピーし、コピーした値を安全な場所に記録します。
重要: 外部コンテンツコネクタアドミンは、 Lucidchart 外部コンテンツコネクタを構成するときにこの SCIM ベアラートークン値を必要とします。
次のタスク
コネクタアドミンに次のアイテムを提供します。
- ステップ 3.d でコピーした OAuth 2.0 クライアント ID。
- ステップ 3.e でコピーした OAuth 2.0 クライアントシークレット。
- ステップ 4.e でコピーした SCIM ベアラートークン。
コネクタアドミンは、Lucidchartソースシステムからドキュメント、フォルダー、セキュリティプリンシパルを取得するためのLucidchart外部コンテンツコネクタを構成するために、これらのアイテムを必要とします。
重要: ステップ
2 で
コネクタアドミンをアプリケーション協力者として招待した場合は、そのアドミンが招待を受け入れていることを確認してください。アプリケーション協力者ロールがないと、
Lucidchart 外部コンテンツコネクタを作成できません。
Lucidchart外部コンテンツコネクターの作成と設定の詳細については、「Lucidchart外部コンテンツコネクタの作成」を参照してください。