Loading

トピック

SCIM を使用したユーザーのプロビジョニングとプロビジョンの解除

Asana EnterpriseEnterprise+ ティア、および 旧 Enterprise ティアで利用できます。SCIM は組織全体のプランでご利用いただけますが、ディビジョンではご利用いただけません。

詳しくは、料金ページをご覧ください。

SCIM 機能により、特権管理者は IdP (アイデンティティプロバイダー) から Asana でのユーザーのプロビジョンとその解除をすばやく簡単に行えます。お客様の組織を使って SCIM を構成することもできます。SCIM プロビジョニングにより、特権管理者は次のことができます。

  • 新規ユーザーの作成
  • ユーザーのプロフィール属性の更新 (Okta および Microsoft Entra ID のみ)
  • Asana ユーザーの ID 管理プロバイダーへのインポート
  • Asana チームの ID 管理プロバイダーへのインポート (Okta のみ)
  • ID 管理プロバイダー (Okta および Microsoft Entra ID のみ) から Asana でチームを作成
  • ユーザーの無効化

以下のプロビジョニング機能は Asana ではサポートされていません。

  • ユーザーの再有効化
  • Asana でのチームの削除
ノート iconノート
Asana を体験してみませんか?今すぐ Asana の無料トライアルを始めましょう。無料で試す

プロビジョニングのセットアップ

SCIM プロビジョニングを使うには、組織の Asana アカウントを対応している ID 管理プロバイダーに接続する必要があります。セットアップ方法はご利用の IdP によって異なります。Asana は次を経由した SCIM プロビジョニングに対応しています。

Okta

機能

特権管理者は Okta から Asana でユーザーのプロビジョンとその解除をすばやく簡単に行うことができます。Asana と Okta の連携は、SCIM と呼ばれる業界標準のプロトコルに基づいています。SCIM を使うと特権管理者は次のことができるようになります。

  • ユーザーの作成: Okta で Asana アプリケーションに割り当てられた Okta ユーザーは、Asana 組織のメンバーとして自動的に追加されます。
  • ユーザーのプロファイル属性の更新: ユーザーのプロファイルの userName (ユーザー名)、title (タイトル)、department (部署) などの属性は、Okta から Asana に同期することができます。
  • ユーザーのインポート: Asana で作成したユーザーを Okta にインポートし、既存の Okta ユーザーに関連づけるか、新しい Okta ユーザーとして作成することができます。
  • グループのインポート: Asana で作成したチームは、Okta のグループとしてインポートできます。Okta では、インポートされたグループのメンバーシップを管理することはできませんのでご注意ください。
  • グループのプッシュ: Okta のグループとそのメンバーを Asana に (Asana のチームとチームメンバーとして) プッシュすることができます。
  • グループのリンク: Asana からチームをインポートした後、Asana の既存のチームを Okta のグループにリンクすることができます。
  • ユーザーの無効化: Okta でアプリから割り当てを解除されたユーザーを、Asana 内で無効化することができます。

現在、以下のプロビジョニング機能はサポートされていません。

  • ユーザーの再有効化
  • Asana でのチームの削除
ノート iconノート
絵文字を名前に含むユーザーやグループを Okta にインポートすると、エラーが発生します。これは、Okta が 3 バイト以下でエンコードされる文字のみをサポートしているためです。

要件

組織の SCIM を有効にする前に、以下の要件を満たしていることを確認してください。

  1. Asana の Enterprise、Enterprise+、または旧 Enterprise プランを利用している組織の特権管理者である。SCIM は組織全体のプランで利用できますが、ディビジョンでは利用できません。
  2. SCIM 経由でユーザーをプロビジョニングできる Okta プランをご利用されている。詳しくは Okta のライフサイクル管理のサービスをご覧ください。

これらの要件を満たしている場合は、以下の手順で組織の SCIM を有効にしてください。

手順

ステップ 1: Asana の Okta 連携アプリを Okta アカウントに追加する

asana okta integration
Okta にログインして、Asana の Okta 連携を追加します。
  1. サイドバーの「アプリケーション」をクリックします。
  2. 「アプリカタログを参照」をクリックします。
asana okta integration2
Asana を追加するには、以下の手順で行います。
  1. 「コラボレーションと生産性」をクリックします。
  2. 「Asana」をクリックします。
add asana


ステップ 2: 組織の Asana アカウントを Okta アカウントに接続する

SCIM プロビジョニングを使用するには、組織の Asana アカウントと Okta アカウントを接続する必要があります。

Asana で次のステップを完了する

Asana の特権管理者アカウントにログインし、管理者コンソールメニューに移動します。具体的には、右上のプロフィール写真をクリックし、**管理者コンソール**をクリックします。「アプリ」タブに移動し、「サービスアカウントを追加」をクリックします。

管理者コンソールからサービスアカウントを追加.gif
権限スコープからスコープ付き権限を選択し、ユーザープロビジョニング (SCIM)ボックスをオンにして、以下のすべての権限がチェックされていることを確認します。スコープ付き権限は、ユーザープロビジョニング(SCIM)へのAPIトークンアクセスのみを提供します。アクセスを制限することで、APIトークンの使用に関連するセキュリティリスクを低減できます。
 
ノート iconノート
Okta による Asana チームへのグループのプッシュ、チーム名の変更、チームの編集を許可しない場合は、チーム関連の権限のチェックを外します。
権限スコープ window.png
 
サービスアカウントを追加すると API トークンが生成されます。これは、Okta 内の Asana アプリの「Provisioning (プロビジョニング)」タブで使用します。
サービスアカウントの追加.png

Okta で次の手順を完了

Okta 管理ポータルにログインし、「Applications (アプリケーション)」タブで「Asana」アプリケーションに移動します。

Okta 管理ポータル
Asana を Okta アカウントに接続するには、以下の手順で行います。
  1. 「Provisioning** (プロビジョニング)」をクリックします。
  2. 「Settings** (設定)」のサイドバーで「Integration** (連携)」をクリックし、「Configure API Integration** (API 連携を設定)」をクリックします。
  3. 「Enable API integration** (API 連携を有効にする)」にチェックを入れます。
  4. 「API Token** (API トークン)」カスタムフィールドに、Asana の「サービスアカウント」タブで取得したトークンを入力します。
  5. 「Test API Credentials** (API 認証情報をテスト)」をクリックして、トークンが正しく設定されていることを確認します。
  6. 「Save** (保存)」をクリックして、Okta に設定を保存します。

ステップ 3: Okta アカウントで Asana のプロビジョニングオプションを設定する

Okta 内で

「Application (アプリケーション)」タブから Asana アプリに移動し、「Provisioning (プロビジョニング)」をクリックします。

Okta のプロビジョニングオプション
プロビジョニングオプションを設定するには、以下の手順で行います。
  1. 「Settings (設定)」のサイドバーで「To App (アプリへ)」をクリックします。
  2. 右上の「Edit (編集)」をクリックします。
  3. Asana アプリのユーザープロビジョニングオプションを有効にし、「Save (保存)」をクリックして連携設定を適用します。
ノート iconノート
「ユーザーの作成」「ユーザー属性の更新」「ユーザーの無効化」を有効にすることをおすすめします。
インポートタブ
「Import (インポート)」タブを使用して、Asana で検出されたユーザーと Okta ドメインに登録されているユーザーを一致させます。Okta アカウントを作成または割り当てる Asana ユーザーをインポートします。
割り当てタブ
SAML の場合と同様に、**Assignments** (割り当て) タブを使用して、Asana に割り当てられたユーザーを管理します。ユーザーと Asana のメンバー一覧との同期は自動的に保たれます。

ステップ 4: プロビジョニングされたユーザーを Asana のチームにマッピングする

Okta のグループを Asana のチームにマッピングするには、新しいグループを Asana にプッシュするか、Okta のグループを Asana の既存のチームにリンクするかを決めることができます。グループをリンクする場合は、グループをマッピングするチームが Asana 内ですでに設定されていることを確認してください。Asana でチームを作成する方法について詳しくはこちらをご覧ください。

Okta 管理ポータルで次の操作を行ってください。

  • Asana アプリにアクセスし、「Push Groups (グループのプッシュ)」タブの「Refresh App Groups (アプリグループの再読み込み)」をクリックして、Asana で発生したインポートや変更を更新します。これにより、対象アプリのすべてのグループが Okta で表示されるようになります。
  • リンク時に Asana のグループ名を変更する機能が必要な場合は、「Group Push Settings (グループプッシュ設定)」のアクションボタンをクリックします。Asana でのチーム名の意図しない変更を避けるため、アプリグループの名前を変更しないことをおすすめします。
プッシュグループ
プッシュグループ

  1. 「Push Groups (グループのプッシュ)」をクリックします。
  2. 「By name (名前で検索)」を選択し、キーワードを使用して Okta でグループを検索します。
  3. 表にグループが表示されたら、「Match results and push action (検索結果とプッシュアクション)」のドロップダウンメニューをクリックします。グループを既存のチームにマッピングしようとしている場合は、**Link Group** (グループをリンク) を選択します。それ以外の場合は、グループを作成を選択します。「保存」をクリックして、連携設定を適用します。
 
ノート iconノート
Okta から Asana のチームを削除することは、この連携ではサポートされていませんのでご注意ください。チームの管理や削除は、Asana の管理者コンソールの「チーム」タブで行えます。

ステップ 5: Asana の属性マッピングの設定

Asana で属性を設定してユーザープロフィールにマッピングするには、以下の手順に従ってください。

  • Asana アプリに移動し、「プロビジョニング」タブをクリックします。
  • 「strong>Asana Attribute Mappings (Asana 属性マッピング)」セクションで適切なオプションを設定します。
  • 「strong>適用先」列の選択肢から「strong>作成」または「strong>作成と更新」を選択します。
属性タイプ情報制限に関するノート
userName文字列ユーザーの一意の識別子。通常、ユーザーがサービスプロバイダーに直接認証するために使用します。各ユーザーには、空ではない userName 値を含める必要があり、それはメールアドレスでなければなりません。必須。必須。
namecomplexユーザーの名前
name.givenstringサポートされていません。フォーマットを使用
name.familyNamestringサポートされていません。フォーマットを使用
name.formattedstringユーザーの氏名
emailscomplexユーザーのメールアドレス
emails.valuestringユーザーのメールアドレス
email.primarystringこのメールアドレスがこのユーザーの優先メールアドレスであるかどうか。True はこの属性に対して 1 回のみ表示されます。
titlestringユーザーのタイトル (例: 「Vice President」)。
departmentstringユーザーが所属する部署の名前を識別します。
preferredLanguagestringユーザーの優先する書面または口頭での言語を示します。たとえば、「en_US」は言語を英語、国を米国と指定する。使用する言語は、ユーザーが Asana で作成されるときにのみ設定可能。既存の Asana ユーザーの場合、Okta の preferredLanguage カスタムフィールドを更新しても、その変更は Asana には反映されません。
activebooleanユーザーのアカウントが Asana でアクティブであるかどうかを示します。

addresses

複数値の複合型

ユーザーの勤務先住所

address.country

stringユーザーの国名 (2 文字のコード。「US」など)

address.region

stringユーザーの地域 (例: 「CA」)

address.locality

文字列

ユーザーの都市 (例: 「San Jose」)

phoneNumbers複数値の複合型

ユーザーの電話番号

phoneNumber.value文字列

ユーザーの電話番号例:

“543-111-1111”

ユーザー

複雑

ユーザーの Enterprise ユーザースキーマ拡張属性

User.departmentstring

ユーザーが所属する
部署名

User.costCenterstring

ユーザーが所属するコストセンターの名前

User.organizationstring

ユーザーが所属する組織の名前

User.divisionstring

ユーザーが所属するディビジョンの名前

User.employeeNumber文字列

個人に割り当てられた文字列識別子 (通常は数字または英数字)

User.manager
複合

ユーザーのマネージャー

User.manager.value文字列

ユーザーのマネージャーのユーザー ID


ステップ 6: 現在の Asana と Okta の連携を更新する方法

現在、Asana と Okta の連携を使用している場合は、以下の手順で最新情報を有効化またはアクセスしてください。

連携を更新する

  1. 「プロビジョニング」をクリックします。
  2. 「連携」をクリックします。
  3. 「編集」をクリックします。
  4. 「API 連携を有効にする」のチェックを外し、「保存」をクリックします。

次に、再度編集をクリックし、API連携を有効化にチェックを入れ、APIトークンを入力して保存をクリックします。そして、プロビジョニング機能を有効にします。この手順の後、新しい属性の更新や連携機能が反映された状態になります。

  • Okta 内で Asana からユーザーのプロビジョンを解除すると、そのユーザーは Asana 内で削除されます (Asana の UI 内でアカウントが削除されたときと同じ動作が発生します)。ユーザーを無効化する場合は気をつけてください。
  • Asana アプリを Okta のユーザーに割り当てると、Asana 内でユーザープロフィールが作成され、そのユーザーが Asana に招待されたときと同じ動作が発生します。ユーザーに Asana アプリを割り当てたことを知らせるときは、このことに注意してください。Asana のアプリケーションレベルで Okta のユーザー名を変更すると (ユーザー名の上書き)、以前のユーザー名の無効化コールが Asana に対して発行されます。この以前のユーザー名がアクティブな Asana アカウントに関連付けられていた場合、このユーザー名は削除されます。アプリケーションレベルのオーバーライドを適用する際には注意してください。
  • ユーザーを作成または更新する場合、そのユーザーは Asana の組織に対応するメールアドレスを持っている必要があります (たとえば、@asana.com のメールドメインを持つユーザーは、asana.com の Asana 組織にのみプロビジョニングできます)。なお、組織ゲストのプロビジョンと解除は、引き続き管理者コンソールの「メンバー」タブで行います。不一致が見つかった場合、formattedName が優先され、givenName と familyName のカスタムフィールド値の変更が元に戻されるか、上書きされる可能性があります。そのため、属性マッピングまたはアプリのユーザープロフィールの手動更新の際は、プロフィールのプッシュ時に、formattedName の値が givenName と familyName の文字列の組み合わせと一致していることを確認してください。例:
    • givenName = 新しい名
    • familyName = 新しい姓
    • formattedName = 新しい名 新しい姓

OneLogin

OneLogin を使った SCIM プロビジョニングの設定方法はこちらをご覧ください。

ノート iconノート
ネイティブ連携でない IdP で SCIM 機能を使用する場合は、こちらから必要なパーミッションをご確認ください。

SCIM を使用したプロビジョン解除のカスタマイズ

組織の特権管理者は、SCIM または API を介してプロビジョンを解除されたユーザーのタスクの処理方法を選択できます。

ユーザーが Asana からプロビジョン解除されると、そのユーザーに割り当てられていたすべての公開タスクを含む「以前に割り当てられたタスク」プロジェクトが作成されます。

管理者コンソールの組織全体の設定では、このプロジェクトのオーナーとなる特権管理者を選択できます。プロジェクトオーナーは、必要に応じてタスクを再割り当てできます。

プロジェクトオーナーの役割を特権管理者に割り当てるには

プロビジョンの解除
管理者コンソールの「セキュリティ」タブにある「メンバー削除設定」に移動します。 member removal settings
  1. 「削除されたメンバーに割り当てられていたタスク用に新規プロジェクトを作成」オプションをオンにします。
  2. ドロップダウンメニューから「すべての特権管理者」または特定の特権管理者を選択します。
  3. 完了したタスクをプロジェクトに含める場合は、チェックボックスをオンにします。
ノート iconノート
これらのカスタマイズ設定は、ユーザーがサービスアカウントトークンを使用して SCIM または API を介して組織から削除された場合にのみ適用されます。

ユーザーのプロビジョンの解除について詳しくは、FAQ の記事をご覧ください。

Note iconノート

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

翻訳に関するフィードバックを送る。
読み込み中
SCIM を使用した Asana でのユーザーのプロビジョニングとデプロビジョニング