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

トピック

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

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

この記事の内容

この機能を利用できるユーザー
EnterpriseEnterprise+旧 Enterprise

詳細は料金ページをご確認ください。

ノート iconノート

SCIM 経由で Asana に同期された属性データは、Asana Intelligence (Dash) などの AI 機能を含む、Asana のすべての後続機能で利用できます。特定の属性をこれらの機能で表示したくない場合は、Asana に同期される前に、Okta や Microsoft Entra ID などの ID プロバイダーの SCIM 設定からその属性を削除するか、マッピングを解除してください。

SCIM 用の Asana サービスアカウントをセットアップする

IdP に関わらず、すべての SCIM 連携は Asana サービスアカウントトークンを使用して認証を行います。以下の IdP 固有の手順のいずれかに従う前に、この設定を 1 度行ってください。

  1. 管理者アカウントで Asana にサインインし、トップバーのプロフィール写真から管理者コンソールを開きます。
  2. 「アプリ」タブに移動して、「サービスアカウント」を選択します。
  3. 「サービスアカウントを追加」を選択します。
  4. 「権限スコープ」で「スコープ付き権限」を選択し、「ユーザープロビジョニング機能 (SCIM)」を有効にします。ID プロバイダーによる Asana チームの作成、名前の変更、または編集を希望しない場合は、チーム関連のスコープのチェックを外したままにしてください。
  5. 変更内容を保存し、生成された API トークンをコピーします。以下の手順で、これを IdP の SCIM 設定に貼り付けます。
ノート iconノート

このトークンは厳重に保管してください。トークンを持つ人は誰でも、組織内のメンバーのプロビジョンとその解除を行うことができます。

 

Okta

機能

特権管理者は Okta から Asana のユーザーのプロビジョンとその解除を簡単に行うことができます。この連携は SCIM プロトコルに依存しており、以下をサポートします。

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

現在サポートされていない機能: メンバーの再有効化、Okta からの Asana チームの削除。

要件

  • Asana の Enterprise、Enterprise+、または旧 Enterprise プランを利用している組織の特権管理者である。[公開前に確認 — ある社内ソースでは、3 つのプランすべてで特権管理者ではなく、「Enterprise プラン」でのみ「管理者」と記載されています。エンジニアリング部門またはサポート部門に正しい要件を確認してください。組織変更提案の未解決の質問 #5 を参照してください。]
  • ライフサイクル管理プロビジョニングをサポートする Okta プランをご利用です。
  • 上記の「SCIM 用の Asana サービスアカウントを設定する」を完了しました。

無効化を有効にする前に、次の点にご注意ください。Okta でメンバーを無効化すると、Asana へのアクセスが一時停止されるだけでなく、Asana でそのメンバーのアカウントが削除されます。これは、Asana の UI からそのメンバーを削除することと同じです。「無効化されているが復元可能」という別の状態はありません。同様に、Okta のアプリケーションレベルでメンバーのユーザー名を上書きすると、以前のユーザー名に紐付けられていた Asana アカウントがアクティブであった場合、そのアカウントは削除されます。以下のステップ 3 でユーザーの無効化を有効にする前、またはユーザー名のオーバーライドを適用する前に、この 2 点にご留意ください。

ステップ

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

Okta にログインして、「Applications (アプリケーション)」の「App Integration Catalog (アプリ連携カタログ)」から Asana の連携アプリを組織に追加します。

asana okta integration
asana okta integration2
Asana を追加するには、以下の手順で行います。
  1. 「Collaboration and Productivity (コラボレーションと生産性)」をクリックします。
  2. 「Asana」をクリックします

add asana


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

Asana で:上記の手順に従ってサービスアカウントトークンを生成し、コピーします。

Okta 内で:

  1. 「アプリケーション」で Asana アプリケーションを開き、「プロビジョニング」タブをクリックします。
  2. 「Settings (設定)」で「Integration (連携)」をクリックし、「Configure API Integration (API 連携の設定)」をクリックします。
  3. 「Enable API Integration** (API 連携を有効にする)」にチェックを入れ、「API Token** (API トークン)」フィールドにサービスアカウントトークンを貼り付け、「Test API Credentials** (API 認証情報をテスト)」をクリックして接続を確認します。
  4. 「保存」をクリックします。

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

  1. Asana アプリの「Provisioning」(プロビジョニング)タブで、「To App」(アプリへ) をクリックし、「Edit」(編集) をクリックします。
  2. 必要なプロビジョニングオプションを有効にします。「ユーザーの作成」「ユーザー属性の更新」「ユーザーの無効化」を有効にすることをおすすめします。
  3. 「保存」をクリックします。
  4. 「Import (インポート)」タブを使用して、Asana で検出されたメンバーと Okta ディレクトリを一致させ、「Assignments (割り当て)」タブを使用してプロビジョニングされたメンバーを管理します。割り当てられたメンバーは、今後 Asana のメンバー一覧と自動的に同期されます。

 

okta provisioning options
プロビジョニングオプションを設定するには、以下の手順で行います。
  1. 「Settings (設定)」のサイドバーで「To App (アプリへ)」をクリックします。
  2. 右上の「Edit (編集)」をクリックします。
  3. Asana アプリのユーザープロビジョニングオプションを有効にし、「Save (保存)」をクリックして連携設定を適用します。
ノート iconノート
「ユーザーの作成」「ユーザー属性の更新」「ユーザーの無効化」を有効にすることをおすすめします。
import tab


assignments tab

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

新しい Okta のグループを Asana にチームとしてプッシュするか、Okta のグループを Asana の既存のチームにリンクすることができます。

  1. Okta の Asana アプリで「Refresh App Groups (アプリグループの再読み込み)」をクリックして、Asana で最近行われた変更を取り込みます。
  2. 「Push Groups (グループをプッシュ)」タブに移動し、名前でグループを検索します。
  3. 一致結果から「Link Group (グループをリンク)」を選択して既存の Asana チームにマッピングするか、「Create group (グループを作成)」を選択して新しいチームを作成します。
  4. 「保存」をクリックします。

Okta から Asana のチームを削除することはできません。代わりに、Asana の管理者コンソールの「チーム」タブを使用してください。

 
push groups

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

    Asana アプリの「Provisioning」(プロビジョニング) タブの「Asana Attribute Mappings」(Asana 属性マッピング)で、同期する各属性に対して「Create」(作成) または「Create and Update」(作成および更新) を選択します。サポートされている属性は次のとおりです。

    属性

    タイプ

    ノート

    ユーザー名

    文字列

    必須。Asana 組織のドメインに一致する一意のメールアドレスである必要があります。

    name.formatted

    文字列

    メンバーの氏名。これを使用してください。name.givenNameとname.familyNameは個別にサポートされていません。formattedが名 / 姓に設定されている内容と一致しない場合、formattedが優先され、これらのフィールドが自動的に上書きされることがあります。

    emails.value

    文字列

    メンバーのメールアドレス。

    emails.primary

    ブール値

    プライマリメールアドレスをマークします。メインとして指定できるメールは 1 つのみです。

    タイトル

    文字列

    メンバーの役職。

    部署

    文字列

    メンバーの部署。

    preferredLanguage

    文字列

    メンバーが最初に作成されたときにのみ適用されます。その後 Okta 側でこのフィールドを更新しても、既存のメンバーには反映されません。

    アクティブ

    ブール値

    メンバーのアカウントが Asana で有効かどうか。

    特定の属性の同期を停止する場合は、Okta でその属性を削除するか、マッピングを解除してください。Asana には個別の除外コントロールはありません。マッピングを削除すると、今後の同期は停止しますが、すでに同期されたデータは削除されません。

    ステップ 6: 既存の Asana–Okta の連携を更新する

    すでに稼働している連携に新しい属性や機能を追加するには、次の手順に従ってください。

    1. 「連携」ページの「プロビジョニング」で「編集」をクリックします。
    2. 「API 連携を有効にする」のチェックを外し、「保存」をクリックします。
    3. もう一度「編集」をクリックし、「API連携を有効にする」を再度チェックして、APIトークンを再入力し、「保存」をクリックします。
    4. 必要なプロビジョニング機能を再度有効にします。
    update integration

      その他の留意事項

      • 名前に絵文字が含まれていると、インポートに失敗します。Okta は 3 バイト以下でエンコードされる文字のみをサポートしているため、絵文字を含むメンバー名やグループ名はインポートできません。
      • プロビジョニングされたメンバーのメールアドレスは、Asana 組織のドメインと一致する必要があります。ゲストのプロビジョンと管理は、引き続き管理者コンソールの「メンバー」タブでのみ行います。
      • このセクションにスキップした場合は、上記の無効化およびユーザー名の上書きに関する警告を参照してください。これらの設定を有効にしたタイミングに関わらず、適用されます。

      Microsoft Entra ID

      Asana の Microsoft Entra ID 連携は、主に Microsoft 独自のプロビジョニングチュートリアルを通じて設定されます。これは、設定がすべて Entra 管理センターで行われるためです。まず、Asana 固有のこれらのステップを完了してから、Microsoft の手順に従って Entra 側の設定を行います。

      要件

      • Enterprise プラン以上をご利用の Asana 組織で、管理者権限を持つメンバーアカウントがあること。
      • アプリケーション管理者、クラウドアプリケーション管理者、またはアプリケーション所有者のロールを持つ Microsoft Entra アカウント。
      • 上記の「SCIM 用の Asana サービスアカウントを設定する」を完了し、トークンを用意していること。

      ステップ

      1. Microsoft Entra のアプリケーションギャラリーから Asana を追加します (テスト中は、既存の SSO 連携とは別のアプリを使用することをおすすめします)。
      2. Microsoft のチュートリアル「Microsoft Entra ID を使用したユーザーの自動プロビジョニングのために Asana を設定する」に従って、次の操作を行います。
        • 「プロビジョニング」>「テナント URL」で、Asana テナントの URLと上記で生成したサービスアカウントトークンを入力し、接続をテストします。
        • プロビジョニングの対象となるユーザーを定義します (割り当てまたは属性ベースのスコーピングフィルターを使用)。
        • ユーザーとグループの属性マッピングを見直し、確認します。
        • プロビジョニングを開始し、Microsoft のプロビジョニングログでステータスをモニタリングします。

      この設定は Entra 管理センターで行われるため、最新のスクリーンショットと操作手順については Microsoft のチュートリアルを参照してください。上記の Asana の属性マッピングとサービスアカウントの要件は、Microsoft の UI の変更に関係なく変わりません。

      Google Workspace

      Google Workspace を IdP として使用しており、Asana で SCIM プロビジョニングを設定したい場合は、担当のアカウントエグゼクティブまたはAsana サポートにお問い合わせの上、現在の設定方法についてお尋ねください。

      OneLogin

      Asana の OneLogin 連携は、OneLogin 上で直接設定します。詳しい手順については、OneLogin の Asana 用 SCIM プロビジョニング設定ガイドに従ってください。

      Asana とネイティブ連携されていない ID プロバイダーで SCIM を設定する場合は、Asana のデベロッパー向けドキュメントでサポートされている SCIM 属性に関する記事をご覧になり、許可される属性の全リストをご確認ください。

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

      メンバーが SCIM またはサービスアカウントトークンを使用した API を介して Asana からプロビジョンを解除された場合、そのメンバーの公開タスクが格納された「以前に割り当てられたタスク」プロジェクトが Asana によって自動的に作成されます。そのプロジェクトのオーナーを次のように設定できます。

      1. 管理者コンソールの「セキュリティ」タブに移動し、「メンバー削除設定」を開きます。
      2. 「以前に割り当てられたタスク」プロジェクトのオーナーとして、特権管理者 (またはすべての特権管理者) を割り当てる設定をオンにします。
      3. 必要に応じて、完了したタスクを含めるかどうかを選択します。

      このカスタマイズは、メンバーが SCIM またはサービスアカウントトークンを使用した API を介して削除された場合にのみ適用されます。Asana の UI から手動で削除された場合は適用されません。メンバーが削除された場合に何が起こるかについて詳しくは、「ユーザーのプロビジョンの解除」をご覧ください。

      Note iconノート

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

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

      関連記事

      読み込み中
      Asana SCIM: ユーザープロビジョニングの自動化 | ヘルプセンター