本ページでは、アプリ連携を作成し、Josysの連携アプリ以外のアプリをご連携頂く機能について説明しています。
概要
本ページでは、アプリ連携を作成し、Josysの”連携アプリ”以外のアプリをご連携頂く機能について説明しています。
想定読者
- JosysのIT管理者
- カスタムアプリを作成し、アプリの管理を手動で行っているお客様
できること
Josysには連携が出来るアプリと出来ないアプリがあります。Josysと連携できるアプリは"連携アプリ"と呼んでいます。
Josysが連携アプリを増やしていくためには、連携先のアプリ側がAPIを解放していることが条件であり、全てのアプリの連携が出来ない状況です。そのようなアプリは「カスタムアプリ」として手動で作成頂いているケースがあります。
ですが、JosysのAI連携ビルダーを使うことで、連携アプリ以外も自動で情報を取得して頂ける場合がございます。そのためには、連携先アプリ側が下記条件に一致していることが必要です。
- 二段階認証や、IPアドレス制限を行っておらず、IDとパスワードを入力してログインするアプリ
- ユーザー一覧が確認できるアプリ
- ログイン後、アプリ側にポップアップガイドなどが表示されないアプリ
- ボット対策等のセキュリティ機能が導入されていないアプリ
このログインは通常のユーザーログインと同様に行われるため、連携先アプリ側のログイン履歴や監査ログに記録されます。
利用条件
- Google Chrome での設定のみサポートされています。
- Josys Browser Extension のインストールが必要です。
参考：ブラウザ拡張機能について
アプリ連携の設定方法
1.事前設定
- chrome://extensions/ にアクセスします。
- Josysの拡張機能の詳細設定画面から「シークレットモードでの実行を許可する」をONにしてください。
2.アプリ連携の作成
- Josys左サイドメニューより、「連携＞アプリ連携」をクリックします。
- 最下部までスクロールし、「新規アプリ追加」をクリックします。
- 右側にウィンドウが開きます。
- 初回のアプリ連携作成時は、同意が必要です。右上の「同意する」をクリックしてください。
- その後、ポップアップが開くため、再度「同意する」をクリックしてください。
- アプリ詳細を入力します。アプリ名とアプリのログインURLをご入力ください。
- 「アプリを確認する」をクリックしてください。
- 連携に必要な手順が表示されます。右下の「アプリ連携を作成」ボタンをクリックしてください。
3.アプリ連携の設定
アプリにログインする
- 先ほど入力いただいたURLが、新しいウィンドウで開きます。
- ログイン画面にて、右下にガイドが表示されます。
- ”認証情報でログイン”の右側に表示される「開始」をクリックしてください。
クリックするとガイドは非表示になります。 - アプリに再度ログインをしてください。
- ログイン後、再度右下にガイド表示されるまでお待ちください。
- 右下にガイドが表示されます。
- ログイン完了後、「完了」ボタンをクリックしてください。
4.アプリユーザーリストを設定する
- 「アプリユーザーリストに移動」の右側に表示されている「開始」をクリックしてください。
- アプリのアカウント一覧（アプリ自体にログインができるユーザー一覧）のページを開いてください。
- ユーザーリストに移動が完了したら、ガイドをクリックし、ユーザーリストへの移動を完了してください。
- ガイドに”アプリユーザーの詳細”が表示されたらクリックし、中に表示される「開始」ボタンをクリックしてください。
-
”3つのメールIDを選択”というガイドが右下に表示されたら、ユーザー一覧画面上でユーザーのメールアドレスを示す欄を3か所クリックしてください。
※キャプチャの例だと、「EMAIL ADDRESS」という列のメールアドレスを3つクリックします。※画面上にメールアドレスの列がない（またはIDがメールアドレスでない）場合は、「スキップ」をクリックし、メールアドレスなしでも連携が可能です。その場合、この後の「ユーザー名」の設定が必須となります。
ただし、メールアドレスをスキップして連携した場合、取り込まれたアカウントは「未管理ユーザー」として登録されます。
- ユーザー名、権限、ライセンス、最終使用日、ステータス、MFA、も同様に設定します。
それぞれ、該当の列がない項目は「スキップ」をクリックしてください。
※MFA：MFA設定をしているかどうかの列があれば選択してください。
※先ほどメールアドレスの選択をスキップした場合、ユーザー名の選択が必須です。 - 次に、ページネーション/スクロールの有無を登録してください。
スクロールしないとすべてのユーザーが表示されないパターンや、次のページを開かないとすべてのユーザーを認識できないパターンであれば「はい」を選択します。 - ページネーション/スクロールタイプを選択してください。
- ページネーションを記録します。「開始」をクリックしてください。
- アカウント数が少なく、”次へ”のボタンが押せない状態であっても、「次へ」や「前へ」をクリックして頂き、完了としてください。
- 完了したら「ジョーシスに戻る」をクリックしてください。
- 開かれていたウィンドウが閉じます。
Josysでデータを確認する
- Josysの画面に戻ったら、右下の「データを確認してアプリを追加」をクリックしてください。
- アプリ統合の構築が完了したら、右下の「アプリを追加」をクリックしてください。
アプリの削除手順
- Josys左サイドメニューより「連携＞アプリ連携」をクリックし、該当のアプリ（ステータスが「連携失敗」等）を選択します。
- 画面右側に詳細が表示されますので、右下の「アプリを破棄」ボタンをクリックします。
- 「破棄しますか？」という確認画面が表示されたら、赤色の「破棄」ボタンをクリックします。
よくある質問
Q. 右下のガイドが表示されない
A: 拡張機能の設定をご確認ください。chrome://extensions/ にアクセスし、Josysの拡張機能の詳細設定画面から「シークレットモードでの実行を許可する」をONにしてください。
Q.途中でエラーになりました。
A: 下記の場合エラーとなるため最初からやりなおしてください。
・連携作成途中でリロードをしてしまった場合
また、下記の場合は連携作成をしていただけません。
・SSOログインや、二段階認証をご設定頂いている場合
・IPアドレス制限をしている場合
・連携先アプリにガイドを表示している場合
・ボット防御機能（F5 Bot Defenseなど）が導入されている場合
・ログインページなどのHTML構造が一貫していない、または不明確な場合
Q: アプリ連携のステータスが「レビュー中」になりました。どのような対応が必要ですか？
A: 「レビュー中」は、AI連携ビルダーでのアプリ連携プロセスが、何らかの理由で最後まで正常に完了できなかった状態を示しています。
このステータスに移行した場合は、ジョーシスのエンジニアが連携失敗の具体的な原因を調査し、解決に向けた対応を行います。そのため、お客様側での追加操作や対応は一切必要ありません。
エンジニアによる調査および対応が完了次第、ステータスは自動的に「使用準備完了（Ready to Use）」へ変更されますので、そのままお待ちください。
Q: アプリ連携の作成中にステータスが「レビュー中」となった場合、キャンセルすることはできますか？
A: ステータスが「レビュー中」のアプリ連携は、お客様ご自身でキャンセルや削除を行うことができません。連携のキャンセルをご希望の場合は、サポート窓口までお問い合わせください。
Q: 連携先アプリでIPアドレス制限（ホワイトリスト登録）が行われている場合、ジョーシスのIPアドレスを許可（ホワイトリスト登録）することで連携できますか？
A: いいえ、連携できません。AI連携ビルダーは、連携時に使用する静的IPアドレスを提供していないため、IPアドレス制限の解除やIPホワイトリストへの登録が必要なアプリの連携には対応していません。
Q: 「Josys Browser Extension」をインストールしてAI連携ビルダーを利用する場合、管理者による招待やアクティベーションは必要ですか？
不要です。拡張機能をインストールしたあとアクティベーションを行わずにAI連携ビルダー機能をご利用いただけます。ブラウザ拡張機能のアクティベーションは、検知アプリ機能を利用する場合にのみ必要となります。
Q: アプリ連携のステータスが「連携失敗」になりました。原因を確認することはできますか？
「アプリ連携」画面にて、対象アプリの失敗理由を確認することができます。
例えば、連携先アプリへのアクセスがIPアドレスやVPNで制限されている場合、以下のメッセージが表示されて連携が失敗します。
「This application is not supported because it can only be accessed via an allowed IP address or VPN.」（許可されたIPアドレスまたはVPN経由でのみアクセス可能なため、このアプリはサポートされていません。）
このような制限が設定されているアプリは、AI連携ビルダーによる連携に対応していません。メッセージが表示された場合は、恐れ入りますが連携要件を満たしているか再度ご確認ください。
Q: アプリ連携の設定完了後、アカウント情報が同期されません。
A: アプリ連携の設定手順において、メールアドレスの選択時に「氏名」や「ユーザーID」などメールアドレス以外の項目を誤ってマッピングしている可能性があります。メールアドレスとして正しくないデータがマッピングされている場合、システムがその情報を同期対象外として無視するため、データが反映されません。
この現象が発生した場合は、恐れ入りますが「アプリの削除手順」に沿って一度連携を破棄していただき、正しいマッピング設定で再度アプリ連携を作成し直してください。なお、連携先アプリにメールアドレスの項目がない場合は、メールアドレスの選択ステップで必ず「スキップ」をクリックしてください。