Asana 開発者コンソールで OAuth 2.0 アプリケーションを作成して承認し、Asana外部コンテンツコネクタがAsanaソースシステムにアクセスできるようにします。
始める前に
組織の Asana インスタンスのスーパーアドミンロールが必要です。このロールの詳細については、Asana ヘルプリソース のアドミンロールとスーパーアドミンロール Asana を参照してください。
必要なロール:なし
このタスクについて
Asana 外部コンテンツコネクタは、Asana API を使用してAsanaソースシステムからプロジェクト、タスク、およびコメントを取得します。
コネクタが Asana API を介して Asana ソースシステムにアクセスできるようにするには、Asana 開発者コンソールで OAuth 2.0 アプリケーションを構成して承認する必要があります。コネクタアドミンは、OAuth 2.0 アプリケーションからコピーした設定を使用して、ソースシステムに適切に接続できるように Asana 外部コネクタを構成できます。
手順
-
ログインして Asana し、 Asana 開発者コンソールにアクセスします。
-
https://app.asana.com/に移動し、スーパーアドミンの認証情報でログインします。
-
ユーザーのアバターを選択し、コンテキストメニューから [ 設定 ] を選択します。
-
[設定] モーダル ウィンドウの [アプリ] タブで、[新しいアプリのビルド] セクションを見つけて、[ 開発者コンソールの表示] を選択します。
Asana 開発者コンソールが開きます。
-
Asana 開発者コンソールで、Asana外部コンテンツコネクタ用の新しい OAuth 2.0 アプリケーションを作成します。
-
[ 新しいアプリを作成] を選択します。
-
[新しいアプリを作成 (Create new app)] モーダルウィンドウで、アプリの名前を入力します。
たとえば、「 Asana 外部コンテンツコネクタ」と入力します。
-
[ Asana と別のツールを統合] オプションを選択します。
-
[ I agree to the Asana API Terms (Asana API 規約に同意します )] オプションを選択します。
-
[アプリを作成] を選択します。
新しいアプリの [基本情報] ページが表示されます。
-
[基本情報] ページで、新しい OAuth 2.0 アプリケーションのクライアント ID とクライアントシークレットを記録します。
-
[クライアント ID] フィールドで、[ コピー] を選択して新しいアプリのクライアント ID をコピーし、その値を安全な場所に記録します。
重要: 外部コンテンツコネクタアドミンは、 Asana 外部コンテンツコネクタを構成するときにこのクライアント ID を必要とします。
-
[クライアントシークレット] フィールドで、[ コピー] を選択して新しいアプリのクライアントシークレットをコピーし、その値を安全な場所に記録します。
重要: 外部コンテンツコネクタアドミンは、 Asana 外部コンテンツコネクタを構成するときにこのクライアントシークレットを必要とします。
-
新しいアプリの OAuth リダイレクト URL を構成します。
-
移動先 .
新しいアプリの OAuth ページが表示されます。
-
[リダイレクト URL] セクションで、[ リダイレクト URL の追加] を選択します。
-
[リダイレクト URL を追加] モーダルウィンドウで、「 https://<instance-name>.service-now.com/oauth_redirect.do」と入力し、「 <instance-name> を ServiceNow AI Platform® インスタンスの名前に置き換えて 、[追加] を選択します。
新しいリダイレクト URL が OAuth ページに表示されます。
-
新しいアプリの Asana API 権限スコープを構成します。
-
[OAuth] ページの [権限スコープ] セクションで、次のすべての権限スコープのオプションを選択します。
- 目標:読み取り (
goals:read)
- ポートフォリオ:読み込み (
portfolios:read)
- プロジェクト:読み取り (
projects:read)
- ストーリー:読み込み (
stories:read)
- タスク:読み取り (
tasks:read)
- チームメンバーシップ:読み取り (
team_memberships:read)
- Teams:読み取り (
teams:read)
- ユーザー:読み取り (
users:read)
- ワークスペース:読み取り (
workspaces:read)
-
[変更内容を保存] を選択します。
-
新しいアプリを Asana ワークスペースと共有します。
-
移動先 .
新しいアプリの [配布の管理] ページが表示されます。
-
[ 特定のワークスペース] を選択します。
-
[ ワークスペースの追加] を選択し、新しいアプリを配布する Asana ワークスペースを選択して、 [追加] を選択します。
-
新しいアプリを複数の Asana ワークスペースに配布する場合は、前の手順を繰り返します。
次のタスク
コネクタアドミンに次のアイテムを提供します。
- ステップ 3.a でコピーした新しい OAuth 2.0 アプリケーションのクライアント ID。
- ステップ 3.b でコピーした新しい OAuth 2.0 アプリケーションのクライアントシークレット。
コネクタアドミンは、Asana ソースシステムからプロジェクト、タスク、コメント、およびセキュリティプリンシパルを取得するためのAsana外部コンテンツコネクタを構成するために、これらのアイテムを必要とします。
Asana外部コンテンツコネクターの作成と設定の詳細については、「Asana外部コンテンツコネクタの作成」を参照してください。