Microsoft 365とのマスタ連携でユーザー台帳を作成する – ジョーシスヘルプセンター

【UI表記変更のお知らせ】
順次アップデートに伴い、画面内の「メンバー」表記は「ユーザー」へ変更されております。恐れ入りますが、ヘルプ内に「メンバー」の記載が残っている場合は、適宜「ユーザー」と読み替えてご活用いただけますようお願い申し上げます。詳しい背景等につきましては、こちらのお知らせをご確認ください。

概要

本ページでは、Microsoft 365とマスタ連携をしてユーザー台帳を作成する方法や、詳細を記載しています。

参考：外部システムと連携（マスタ連携）し、ユーザー台帳を作成する

連携される項目

Microsoft 365（Entra ID）と連携していただくことでJosysに連携される項目は下記の6つです。
そのほかの項目はJosysに入らないため、CSV一括登録などでご登録ください。

Microsoft 365の項目名	Josysの項目名
姓	姓
名	名
従業員 ID	従業員番号
ユーザープリンシパル名 ※メールアドレスとの突合に変更可能。	メールアドレス
役職	役職
部署	部署

💡Microsoft 365からJosysに連携される際、ユーザーの種類が「ゲスト」の方は連携されません。

💡Microsoft 365側で1つのアカウントに複数のメールアドレス（エイリアスやセカンダリアドレスなど）を設定している場合でも、ジョーシスに連携・登録されるのは「ユーザープリンシパル名」に設定されているアドレスのみとなります。
追加されたその他のアドレスは同期されません。

💡デフォルト設定の場合、Microsoft 365「ユーザープリンシパル名」からJosys「メールアドレス」へ同期されます。Microsoft 365「メールアドレス」をJosys「メールアドレス」に連携したい場合、タブ「Microsoft 365のメールアドレスをJosysに連携する方法について」をご覧ください。

連携方法

1.アプリ連携の実施

Microsoft 365 (Entra ID)をご参照の上、Josysとのアプリ連携を実施してください。

アプリ連携をすると、「マスタ連携する」というポップアップが表示されるため、「連携する」をクリックしてください。ここまで終了した方は、「3.マスタ連携が成功していることを確認する」に進んでください。

過去にすでにアプリ連携を実施頂き済みの方は、「2.マスタ連携の実施」に進んでください。

2.マスタ連携の実施

各SaaSツールに登録されているユーザー情報をマスタとして利用するため、下記の方法でJosysとのマスタ連携を実施してください。

左サイドバーから「連携＞マスタ連携」をクリックします。
アプリ連携ができている場合、”ユーザー”カテゴリの中に緑の文字で”連携済”と表示されます。
その右側にある「連携」をクリックします。

連携したいワークスペースをプルダウンから選択してください。※アプリ連携の際、名前を付けていない場合は「-」というデータで作成されています。（参考：連携名）
右下の「実行する」をクリックしてください。
「マスタ連携が完了しました」と表示されたことをご確認ください。

3.マスタ連携が成功していることを確認する

左サイドバーから「ユーザー」をクリックし、ユーザー台帳を開きます。
ユーザー台帳に、連携したSaaSツールのアイコンがついたユーザーが登録されていればマスタ連携が完了です。

Microsoft 365から連携されたユーザーのフィルタリング機能

マスタ連携を行うと、Microsoft 365に登録されているユーザーのうち、ユーザータイプが「ユーザー」となっているユーザーがJosysに連携され、ユーザー台帳に登録されます。
その後、Josys上から一部のユーザーのみに絞り込みを行うことで管理対象外のユーザーをJosysのユーザー台帳から削除することができます。

連携＞マスタ連携をクリックします。
Microsoft 365のボックスにある三点リーダー＞メンバのフィルター設定をクリックしてください。
フィルタ条件をセットできる画面が表示されます。
グループ名や、ドメイン名がプルダウンに表示されるため、選択してください。
Microsoft 365側のユーザータイプが「ゲスト」の方も連携したいという場合も、こちらからセットが可能です。
右下の「更新」ボタンをクリックすると、ユーザー台帳内のMicrosoft 365と紐づいているユーザーのうち、
条件外のユーザーは、ユーザー台帳から削除されます。

⚠️ ユーザー台帳から削除され、ログインできなくなることを防ぐためにJosysにログインできるIT管理者が条件に含まれるようにしてください。絞り込みを行うと、アプリのアカウント一覧も、絞り込んだ方のみの表示に切り替わります。

⚠️当機能は、ご希望のお客様からお問い合わせを頂いた場合にのみ解放をしております。

⚠️絞り込みを行って一部のユーザーでユーザー台帳を作成しても、そのほかのアプリでは絞り込みが行われません。

例）ユーザー台帳にグループAのユーザーのみを連携している場合、例えばアプリXをJosysと連携するとアプリXの利用者であるグループAのユーザーはユーザー台帳と紐づけされますが、グループBのユーザーは未管理ユーザーとして登録がされます。

ユーザー情報の同期・更新手順

マスタ連携を行ったあと、JosysとMicrosoft 365は毎朝同期が行われます。同期がおこなれる際の挙動は下記の通りです。

Microsoft 365 (Entra ID)のユーザー情報に登録されている従業員 IDを、
Josysのユーザー台帳内の従業員番号と比較します。
見つかれば、「部署」情報のみを上書きします。
また、その他の項目でJosys側が空欄の項目がある場合は、最新データが登録されます。
一致する従業員 IDが見つからない場合は、Microsoft 365 (Entra ID)のユーザープリンシパル名と
Josysのユーザー台帳内のメールアドレスを比較します。
見つかれば、「部署」情報のみを上書きします。
また、その他の項目でJosys側が空欄の項目がある場合は、最新データが登録されます。

※メールアドレスは、大文字と小文字のどちらも同一として認識されます。
一致するメールアドレスが見つからない場合は、新規ユーザーとして追加します。

⚠️Microsoft 365のアカウントのステータスが有効/無効のいずれで保持されていたとしても、ユーザー台帳上には「在籍中」のユーザーとして情報が作成されます。

💡Josysのメールアドレスへ連携する情報を、ユーザープリンシパル名でなく、メールアドレスとの突合に切り替えすることが可能です。弊社までご連絡いただければと存じます。

Microsoft 365のメールアドレスをJosysに連携する
（「ユーザープリンシパル名」から「メールアドレス」へ切り替える）

　　　〈Microsoft 365「メールアドレス」をJosysに連携したい場合〉

デフォルト設定の場合、Microsoft 365「ユーザープリンシパル名」から、Josys「メールアドレス」へ同期されます。
Microsoft 365「メールアドレス」をJosys「メールアドレス」に連携したい場合、設定の変更が必要です。弊社までその旨ご連絡をお願いいたします。

　　　〈「ユーザープリンシパル名」から、「メールアドレス」へ切り替えを行う際の挙動・注意点〉

メインメールアドレスの上書きについて
Microsoft 365の同期項目を、「ユーザープリンシパル名」から、「メールアドレス」へ設定を切り替えた場合、現在Josysのユーザー台帳に登録されている、メールアドレスが自動的に上書きされます。
紐づけメールアドレスについて
切り替え完了後は、UPNがJosys上の紐づけメールアドレスとして自動で登録される仕様となります。

部署の同期

EntraID内の、「部署」を部署として連携しています。

もし、組織Aという部署をEntraIDの各ユーザーの「部署」に登録するとJosysの部署にも組織Aが連携されてきます。
もしその後、全てのユーザーの「部署」から組織Aを削除したとしても、Josys上からは削除されません。
削除したい場合は、マスタ連携を解除して「設定＞部署」から削除したうえで再度マスタ連携をしてください。

もし、EntraIDの部署情報を連携せず、Josys上で登録編集を行いたい場合は下記のページをご参考ください。
マスタ連携時の「部署」管理について

概要