Azure Entra を DocuWare ユーザー プロビジョニングに統合する方法

組織で Azure Entra を使用して従業員のツールやサービスへのアクセスを管理している場合、Azure プロビジョニング機能を利用して、SCIM 経由でユーザーに DocuWare へのアクセス権を自動的に付与できます。このガイドでは、組織のプロビジョニングを設定するために DocuWare と Azure Entra の両方を構成する手順を説明します。

現在のバージョンの UserSync（v3）は、次のプロビジョニング機能をサポートしています。

• ユーザーの自動作成：Azure でエンタープライズ アプリケーションに割り当てられたユーザーは、DocuWare のユーザーとして自動的に作成されます。

• 属性の同期：Azure でのユーザー属性（userName、email、有効状態）の更新は、DocuWare に反映されます。

• ユーザーの無効化：Azure でユーザーが無効化されると、そのユーザーは DocuWare で無効として設定され、ログインできなくなります。

Microsoft Azure Entra で新しいアプリケーションを作成する

1. Azure ポータルにログインします： Home - Microsoft Azure。

2. Enterprise Applications ページに移動します。

3. New application をクリックします。

4. Create your own application をクリックします。

5. アプリの Name を入力し、Integrate any other application you don't find in the gallery (Non-gallery) を選択します。

6. Create をクリックします。

7. アプリケーションが作成されたら、Overview に移動します。

8. + New configuration をクリックします。
   

9. Azure の設定画面を開いたまま、DocuWare 設定 に切り替えます。

新しい Azure アプリケーションを DocuWare に組み込む

1. DocuWare 設定 > 一般 > ユーザープロビジョニング に移動します。

2. ユーザープロビジョニング プラグインで、ユーザープロビジョニングを有効にする を選択します。

3. Identity Provider ドロップダウンで、Azure Entra を選択します。

4. Application Registration ドロップダウンで、先ほど作成したアプリ登録を選択するか、Create Application Registration をクリックします。

5. Application Name を入力します。

6. 作成したアプリ登録から、次の項目をコピーします。

   1. Application (Client) ID

   2. Client secret

7. Done をクリックします。

8. 保存後、OAuth2 Client Credentials Grant と Bearer Authentication の 2 つの認証方法が表示されます。
   
   

9. プロビジョニングオプション： 新しくプロビジョニングされるユーザーに対して、必要に応じて次のオプションを有効または無効にします。

   1. 登録メールを送信する

   2. 文書トレイを作成する

10. 次の手順は、認証方法によって異なります。

    1. OAuth2 Client Credentials Grant

       • Tenant URL と Token Endpoint のリンクをコピーします。

       • Entra > 対象のアプリケーション > Overview > New configuration > Admin credentials に戻ります。

       • Authentication Method ドロップダウンで OAuth2 Client Credentials Grant が選択されていることを確認します。

       • コピーした Client ID と Client secret を貼り付けます。

       • Tenant URL と Token Endpoint のリンクを貼り付けます。

       • 必須項目がすべて入力されたら、Test Connection をクリックします。

       • Create をクリックします。
         

    2. Bearer Authentication

       • Tenant URL のリンクと、生成された Bearer token をコピーします。

       • Entra > 対象のアプリケーション > Overview > New configuration > Admin credentials に戻ります。

       • Authentication Method ドロップダウンで Bearer Authentication が選択されていることを確認します。

       • Tenant URL のリンクと Bearer token を貼り付けます。

       • 必須項目がすべて入力されたら、Test Connection をクリックします。

       • Create をクリックします。

DocuWare と Microsoft Entra ID でユーザー属性とグループ属性をマッピングする

DocuWare と Microsoft Entra ID の間でユーザー属性とグループ属性をマッピングすると、ユーザーとグループを照合して同期できます。

1. 構成済みのアプリケーションを開き、Overview に移動します。

2. ユーザーをマッピングするには、Attribute Mapping > Users を選択します。
   

3. ユーザー属性のマッピングを設定します。

   1. 必須のマッピング：

      • userName: Item(Split([userPrincipalName], "@"), 1)

      • active: Switch([IsSoftDeleted], , "False", "True", "True", "False")

      • emails[type eq "work"].value: Coalesce([mail],[userPrincipalName])

      • externalId: objectId

   2. 任意のマッピング：

      • name.givenName: givenName

      • name.familyName: surname

4. 補足情報：

   1. userName 属性をマッピングするには、まずその設定を更新します。

      • userPrincipalName の Edit Attribute を開きます。

      • マッピングの種類を Expression に変更します。

      • 式を次のように更新します： Item(Split([userPrincipalName], "@"), 1)

      • Apply をクリックします。
        

   2. email 属性をマッピングするには、まずその設定を更新します。

      • emails[type eq "work"].value の Edit Attribute を開きます。

      • マッピングの種類を Expression に変更します。

      • 式を次のように更新します： Coalesce([mail],[userPrincipalName])

      • Apply をクリックします。
        

   3. externalId 属性をマッピングするには、まずその設定を更新します。

      • externalId: mailNickname 属性の Edit を開きます。

      • Source attribute を objectId に変更します。

      • Apply をクリックします。

5. 不要なマッピングをすべて削除し、Save をクリックします。不要なマッピングを削除しないと、更新されたユーザーをプロビジョニングする際にエラーが発生する場合があります。
   

6. グループをマッピングするには、Attribute Mapping > Groups に切り替えます。

7. グループのマッピングを設定します。

   1. 冗長なマッピング externalId > objectId を削除します。

   2. 変更を保存します。
      

8. グループのスコープフィルターを設定します。

   1. Scoping filters > Groups に切り替えます。

   2. Edit > Scope settings > Groups をクリックします。

   3. Object actions ドロップダウンで、Delete オプションを無効にします。
      

4. 変更を保存します。

ユーザーとグループをプロビジョニングする

Entra アプリケーションの Overview ページに移動し、Start Provisioning をクリックします。

ユーザーのプロビジョニング

1. Manage > Users and Groups > Add user/group をクリックし、プロビジョニングするユーザーを選択して、Assign をクリックします。

2. ユーザーを追加すると、しばらくして自動的にプロビジョニングされます。オンデマンドでプロビジョニングすることもできます。

3. DocuWare 設定 > 一般 > ユーザー管理 に移動します。

4. 想定したユーザーがそこにプロビジョニングされていることを確認します。

グループのプロビジョニング

1. Manage > Users and Groups > Add user/group をクリックし、プロビジョニングするグループを選択して、Assign をクリックします。
   注：グループのメンバーをオンデマンドで割り当てるには、それらのメンバーもリストに追加します。

2. グループとユーザーを追加すると、しばらくして自動的にプロビジョニングされます。オンデマンドでプロビジョニングすることもできます。

3. DocuWare 設定 > 一般 > ユーザー管理 に移動します。

4. 想定したグループとユーザーがそこにプロビジョニングされていることを確認します。

グループのプロビジョニング処理に関する補足情報

1. グループの検索：システムはまず displayName で既存のグループを検索します。その displayName を持つグループが DocuWare に存在する場合は、そのグループを更新します。存在しない場合は、新しいグループを作成します。

2. グループの作成と更新の処理：
   a) 新しいグループの作成：displayName に一致する既存のグループが DocuWare にない場合、サービスは指定されたメンバーで新しいグループを作成します。
   b) 既存のグループの更新：一致するグループが見つかった場合、サービスはそのグループの詳細を更新し、新しいメンバーを追加します。既存のメンバーは新しいメンバーとともに保持されます。

   グループが最初の同期でマッピングされた後は、以降のマッピングには ID 属性が使用されます。たとえば、Entra ID でグループ名を変更し、更新後のグループをプロビジョニングした場合、そのグループは ID によってマッピングされます。サービスは、メンバーを削除することなく、DocuWare 上のグループ名を適切に更新します。

3. メンバーの管理：
   a) メンバーの追加：グループを更新する際、既存のメンバーはそのまま保持され、新しいメンバーが追加されます。
   b) 重複の防止：システムは重複するメンバーの追加を回避するため、各メンバーはグループ内で一意になります。

サポートされているバージョン: DocuWare Cloud