NinjaOne

概要

連携前の準備と利用形態

連携方法は、ご利用中のNinjaOne環境のタイプによって異なります。

1. お客様ご自身が管理する独立したNinjaOne環境の場合
   API Key連携を使用します。
   お客様側でクライアントアプリを作成し、クライアントIDおよびシークレットを発行してください。
2. Josys提供のMSP環境の場合
   OAuth連携を使用します。
   Josys EMSチームより発行された専用のテクニシャンアカウントを受け取り、そのアカウントを使用して連携および認可を行います。
   お客様ご自身でのWebアプリやテクニシャンの作成、複数企業への権限設定は不要です。
   取得される範囲は、発行されたアカウントに設定された権限および組織に従います。

NinjaOneを連携する

NinjaOne側の設定

1. NinjaOneの管理画面にログインします。
2. 「管理」＞「アプリ」＞「API」をクリックします。
3. 「クライアントアプリを追加する」をクリックして新規作成画面を開きます。
4. 「アプリケーションプラットフォーム」で「Web (PHP, Java, .Net Core, etc.)」を選択します。
5. 以下の項目を設定します。
   
   • 名前：任意の名前（例：Josys Integration）
   • リダイレクトURI：
     • JP環境：https://app.josys.it/admin/integrations/callback/ninjaone
     • US環境：https://app.us.josys.it/admin/integrations/callback/ninjaone
   • スコープ：3つのスコープ（「監視」「管理」「制御」）すべてにチェックを入れます。
   • 許可された付与タイプ：「認可コード」および「トークンを更新する」にチェックを入れます。
6. 右下の「追加」をクリックすると、クライアントIDとクライアントシークレットが発行されます。これらの値を控えてください。※シークレットは作成時のみ表示されるため、必ず安全な場所に保管してください。

NinjaOne側の設定

1. Josysのメニューから「連携」＞「アプリ連携」をクリックします。
2. 「NinjaOne」を検索して選択します。
3. 画面右側の設定ページで「連携方法」をプルダウンから選択します。
4. 控えてあるクライアントID、クライアントシークレット、およびお客様環境のベースURLを入力します。
5. 右下の「次へ」をクリックします。
6. OAuth連携の場合はNinjaOneのログイン・認可画面へ遷移します。Josys EMSチームから提供された専用のテクニシャンアカウントを使ってサインインし、連携を認可してください。
7. 連携処理が完了し、接続および同期ステータスを確認できたら設定は完了です。続けてデバイス台帳を連携する場合は、デバイスマスタ連携の設定ページをご確認ください。

注意事項・FAQ

• Q: 連携したNinjaOneのテクニシャンアカウントが、Josys上で取得・表示されません。またデバイスの割り当てもできません。

  NinjaOneの権限設計仕様により、テクニシャンアカウントは他のテクニシャンアカウントを参照できない仕組みになっています。そのため、本連携において連携対象のテクニシャンアカウント自体はJosysに取得・表示されず、該当アカウントへのデバイスの割り当ても手動操作を含めて行えません。あらかじめご了承ください。
• Q: 実際のMFA設定状況と、Josysに表示されるMFA有効ステータスが異なる場合があります。何を確認すべきですか？

  NinjaOneから取得するMFAの有効状態が、実態と異なる表示になる場合があります。Josys上の「MFA有効」表示のみをもって実際にMFAが設定されていると判断せず、必要に応じてNinjaOneの管理画面等で正しい設定状態をご確認ください。