Loading
製品
AI Platform
おすすめ機能
会社の規模別活用方法
チーム別活用方法
業界別
活用事例
学ぶ
サポート
サービス
ヘルプセンター
search-icon

トピック

このトピックに関する記事は見つかりませんでした。

このトピックに関する記事は見つかりませんでした。

このトピックに関する記事は見つかりませんでした。

Advanced 設定: SCIM を使用した Asana の役割の割り当て

この記事の内容

SCIM は、メンバーの作成や更新に加えて、ID プロバイダー内のグループメンバーシップや属性に基づいて、Asana の役割 (管理者、メンバー、ゲスト、またはカスタム役割) を自動的に割り当てることができます。この記事では、OktaとMicrosoft Entra IDの設定について説明します。SCIM を介した役割のマッピングについて、Google Workspace や OneLogin に関する情報は現在記載されていません。

始める前に

  • 基本的な SCIM プロビジョニングはすでに設定済みです。詳しくは、「基本的な設定: SCIM を使用したユーザープロビジョニング機能」を参照してください。
  • 特権管理者の役割は、どちらの IdP でも SCIM を通じて割り当てることができません。特権管理者を指定するには、特権管理者の確認を完了した後、Asana の管理者コンソールを使用します。SCIM は、管理者、メンバー、ゲスト (Okta: サポートされていません。以下を参照)、およびカスタムロールのみを割り当てることができます。
  • Asana では現在、メンバー 1 人につき 1 つの役割のみを割り当てることができます。IdP のグループ設定により、メンバーが複数のロールの対象となる場合は、ロールを優先順位でランク付けします (以下の各 IdP セクションで説明)。これにより、優先順位の高いロールが適用されます。
  • ロールと属性の値にスペースを含めることはできません。代わりにアンダースコアを使用してください (例: custom role 1ではなく、custom_role_1 )。
  • IdP グループを介して「閲覧限定」ライセンスと「Enterprise」ライセンスのプロビジョニングも行う場合(「Advanced セットアップ: SCIM を使用した閲覧限定ライセンスのプロビジョニング」を参照)、両方が同じ優先順位リストにある場合は、ライセンスグループがロールグループよりも優先される必要があります。
  • ロールの記録システムを 1 つ選択します。Asana の管理者コンソールか、IdP のいずれかです。SCIM を介してロールを管理する場合、Asana の管理者コンソールで直接手動で行ったロールの変更は、次回 IdP がそのメンバーの更新をプッシュするときに自動的に上書きされます。

Okta 側のセットアップ

要件

「roles」属性のセットアップ

  1. Okta の Asana アプリケーションで、「プロビジョニング」>「編集可能ユーザー」>「属性の追加」の順に選択します。
  2. 属性を設定します。
    1. データの種類:文字列配列
    2. 表示名: role
    3. 変数名: asana_role
    4. 外部名: roles.^[primary==true].value
    5. 外部名前空間: urn:ietf:params:scim:schemas:core:2.0:User
    6. 「値の列挙リストを定義」にチェックを入れます。
  3. 「Attribute members (属性メンバー)」に、SCIM 経由で割り当てる予定の役割ごとに 1 つのエントリを追加します。最低でも「管理者」と「メンバー」、およびカスタム役割を追加します。ゲストは、Okta で SCIM によって割り当てられるロールとしてサポートされていません。ゲストは外部のメールドメインを使用するため、Okta SCIM for Asana を介してロールを割り当てることはできません。
  4. Asana の管理者コンソールで「ロールの管理」に移動し、各ロールの三点リーダーアイコンをクリックして「ID をコピー」を選択します。各役割の ID を、Okta の該当する「属性メンバー」エントリの「値」フィールドに貼り付けます。
  5. 「Attribute Type (属性タイプ)」を「Group (グループ)」に、「Group Priority (グループの優先度)」を「Combine values across groups (グループ間で値を結合)」に設定し、「Save (保存)」をクリックします。

「属性タイプ」を「グループ」のままにすると、グループ単位で役割を管理できます。メンバーごとにのみ役割を管理する場合は、Personalを選択してください。

Okta の割り当てグループを設定し、カスタム属性にマッピングする

  1. 「ディレクトリ」>「グループ」>「グループを追加」の順に移動し、ロールごとに 1 つのグループを作成します (管理者、メンバー、カスタムロール)。
  2. 各グループについて、「Applications (アプリケーション)」>「Assign applications (アプリケーションを割り当てる)」に移動し、Asana の連携を割り当て、「Role (ロール)」属性の値をそのグループのロールに一致するように設定します。
  3. 「Save and Go Back (保存して戻る)」をクリックし、すべての役割グループに対してこの手順を繰り返します。

グループごとに 1 つの役割のみを選択してください。

ユーザーにロールグループを割り当てる

  1. ロールグループの「メンバー」タブ (Okta における組織のメンバーの呼称) を開き、「メンバーを割り当てる」をクリックします。
  2. 高度な検索を使ってメンバーを一括で割り当てるか、検索して個別にメンバーを追加します。
  3. そのロールを必要とするすべてのユーザーを割り当てたら、「完了」をクリックします。

役割を個別に変更する

  1. 「ディレクトリ」>「メンバー」の順にアクセスし、メンバーを検索します。
  2. そのメンバーの「グループ」タブを開き、現在の役割グループを見つけて、「x」アイコンをクリックしてそのメンバーを削除します。
  3. 上記の手順に従って、別の役割グループに追加します。次の同期時に、Asana の役割がそれに合わせて更新されます。

ロールの優先順位をランク付けする

Asana では、メンバー 1 人につき 1 つの役割を設定できます。メンバーが複数の役割にマッピングされている Okta グループに割り当てられている場合、Asana は優先順位が最も高い役割グループを使用します。

  • 権限の多いロールを上位に配置します。たとえば、管理者をメンバーより上に配置すると、重複が発生した場合、より権限の高いロールが優先されます。カスタム役割にも同じロジックを適用してください。
  • 順番を変更するには、「Applications (アプリケーション)」>「Asana」>「Assignments (割り当て)」>「Groups (グループ)」に移動し、各グループカードのハンドルを使用してグループを優先順位の順にドラッグします。

Okta グループを使用して Asana ライセンス (Enterprise と閲覧限定 —「Advanced 設定: SCIM を使用した閲覧限定ライセンスのプロビジョニング」を参照) を管理する場合も、同じ優先順位リストでライセンスグループをロールグループよりも上に配置します (例: Enterprise、次に閲覧限定、次に管理者、次にメンバー)。

Microsoft Entra ID 側のセットアップ

要件

Entra ID でロール属性と属性マッピングをセットアップする

  1. 接続済みの Asana アプリケーションの「プロビジョニング」タブで、「マッピング」を展開し、「Microsoft Entra ID ユーザーのプロビジョニング」をクリックします。
  2. 「Show advanced options (高度なオプションを表示)」にチェックを入れ、「Edit attribute list for Asana (Asana の属性リストを編集)」をクリックします。(このオプションが利用できない場合は、上記のスキーマ編集可能ユーザーの前提条件を再確認してください。)
  3. 「rbacRoles」という名前の新しいユーザー属性を追加し、タイプを「文字列」にして保存します。
  4. 「属性マッピング」に戻り、「新しいマッピングを追加」をクリックします。
    • マッピングタイプ:式
    • 式:各役割の値 (たとえば、「admin」、「member」、またはカスタム役割の値) について appRoleAssignments をチェックし、一致する Asana の役割 ID を出力する Join/IIF/Instr 式:

Join(",",

  IIF(Instr(Join("", AppRoleAssignmentsComplex([appRoleAssignments])), "\"value\":\"admin\"", , )>"0", "<asana_role_id>", ""),

  IIF(Instr(Join("", AppRoleAssignmentsComplex([appRoleAssignments])), "\"value\":\"custom_role\"", , )>"0", "<asana_role_id>", ""),

  IIF(Instr(Join("", AppRoleAssignmentsComplex([appRoleAssignments])), "\"value\":\"member\"", , )>"0", "<asana_role_id>", "")

)

 

  • ターゲット属性: rbacRoles
  • この属性を使用してオブジェクトを照合:いいえ
  • このマッピングを適用:常に
  • デフォルト値をスキップします。

  1. 各 <asana_role_id> を取得するには、Asana で「ロールの管理」に移動し、各ロールの横にあるドロップダウンを使用して「カスタム ID をコピー」を選択します。SCIM 経由で割り当てる予定のすべての標準の役割 (メンバー、管理者、ゲスト) とすべてのカスタムの役割について、この操作を行ってください。特権管理者は除外されます。特権管理者は Asana の管理者コンソールでのみ割り当てられます。

  2. 「OK」をクリックしてから、「保存」をクリックします。

式における役割の順序によって、割り当ての優先度が決まります。最初に記載されているロールの優先度が最も高くなります。メンバーがマッピングされた複数のグループに属している場合、優先度が最も高いロールが割り当てられます。たとえば、メンバーグループと管理者グループの両方に属するメンバーは、Asana で管理者権限を付与されます。

ロール名にスペースを含めることはできません。代わりにアンダースコアを使用してください。

アプリのロールを設定する

  1. Entra で、「管理」>「ユーザーとグループ」>「アプリケーションの登録」の順に移動します。
  2. 上記の式で設定された役割と一致するように、「アプリの役割を作成」を役割ごとに 1 回ずつクリックします。

役割

表示名

値

説明

メンバー

Asana のメンバー

人のメンバー

Asana メンバーの役割

管理者

Asana 管理者

管理者

Asana 管理者の役割

カスタムロール

Asana <カスタム役割名>

custom_role_1

Asana カスタムロール #1

各項目で「このアプリのロールを有効にする」にチェックを入れ、「適用」をクリックします。

ここで設定する値は、上記の式マッピングで使用されている名前と完全に一致する必要があります。スペースは使用せず、代わりにアンダースコアを使用してください。

Asana の各役割ごとに Entra グループを作成し、そのグループに役割を割り当てる

  1. Asana の役割ごとに Entra セキュリティグループを 1 つ作成します。
  2. Asana Enterprise アプリケーションの「ユーザーとグループ」で「ユーザー / グループを追加」をクリックし、各グループを対応するアプリのロールにマッピングします。
  3. 適切なグループにメンバーを追加します。次のプロビジョニングサイクルが実行される (またはオンデマンドプロビジョニングがトリガーされる) と、Asana に割り当てられた役割が反映されます。

初めてのプロビジョニングに関する順序の警告:初めてプロビジョニングされるメンバーに対して、Entra グループを介してライセンスと役割の両方を同時に割り当てる場合は、順を追って行ってください。まず一方 (ライセンスまたは役割) を割り当て、メンバーが正常にプロビジョニングされたことを確認してから、もう一方を割り当てます。両方を一度に割り当てると、Entra はそのメンバーの「更新」として、2 つのうち 1 つのみを登録します。

役割とライセンスのプロビジョニングを組み合わせる

SCIM を介して「閲覧限定」ライセンスと「Enterprise」ライセンスの両方をプロビジョニングしている場合 (「Advanced 設定: SCIM による「閲覧限定」ライセンスのプロビジョニング」を参照)、同じ IdP で「ライセンス」と「ロール」の 2 つの属性を管理することになります。Okta の場合は、同じ優先順位のグループリストを介して管理することになります。両方が正しく設定された後の最終的な状態は以下のようになります。

Okta では、ライセンスグループとロールグループの両方が同じ「Applications」>「Asana」>「Assignments」の優先順位リストにあります。ライセンスグループはロールグループよりも上位に、各カテゴリ内では、権限の高いグループが権限の低いグループよりも上位にランク付けされる必要があります。Enterprise / 閲覧限定ライセンスと管理者 / メンバーの役割がある組織の場合、最終的な優先順位は上から下に次のようになります。

  1. Asana - Enterprise (ライセンス)
  2. Asana - 閲覧限定(ライセンス)
  3. Asana - 管理者(ロール)
  4. Asana - メンバー(役割)

Enterprise グループおよび管理者グループのメンバーは、Enterprise ライセンスと管理者ロールを取得します。閲覧限定グループとメンバーグループのみに属するメンバーは、閲覧限定ライセンスとメンバーのロールを取得します。各カテゴリ内で重複がある場合は、そのカテゴリで最もランクの高いグループが優先されます。

Microsoft Entra ID では、ライセンス (userType) とロール (rbacRoles) は 2 つの独立した属性マッピングであり、それぞれが独自のアプリロールと Entra グループのセットによって決定されます。Okta のグループのように、単一の優先順位リストを共有することはありません。これらが相互作用するのは、初めてのプロビジョニング時のみです。メンバーにライセンスとロールの両方を初めて割り当てる場合は、上記の順序に関する警告に従って、両方の Entra グループを一度に割り当てるのではなく、順番に割り当ててください (1 つを割り当て、適用されたことを確認してから、もう 1 つを割り当てる)。

既知の制限事項

  • SCIM を介した役割のマッピングは、現在、Okta と Microsoft Entra ID についてのみ文書化されており、Google Workspace や OneLogin については文書化されていません。

 

Note iconノート

この記事は AI によって翻訳されています。

翻訳に関するフィードバックを送る。

関連記事

読み込み中
高度な設定: SCIM を使用して Asana のロールを割り当てる | Asana ヘルプセンター