Jira Service Managementとのチケットシステム連携
本ナレッジでは「チケットシステム連携」機能を利用し、Jira Service Managementのチケットによりリソースへのアクセスを制御する手順を解説します。
チケットシステム連携の仕組みや概要についてはPassword Manager Pro（以下、PMPとします）ナレッジベース「チケットシステムを連携して特権IDの利用申請、承認プロセスを高度化する」をご参照ください。
チケットシステム連携で実現すること
PMPとチケットシステムを連携することで、「申請、承認プロセスの一元化」、「段階的な承認フローの使用」、「各種サービスへの申請・承認通知」を実現し、特権IDのパスワード利用の申請、承認プロセスを効率化および強化することができます。
詳細は「チケットシステムを連携して特権IDの利用申請、承認プロセスを高度化する」の「チケットシステム連携で実現すること」をご確認ください。
手順
以下、Jira Service Managementのスペースはすでに作成されていることを前提として説明します。Jira Service Managementの詳細はJira公式サイトのドキュメントをご確認ください。
OAuth 2.0 Appの設定
PMPはJIRAのAPIを介してJIRA Service Management上のチケット情報にアクセスします。連携設定を行うため、JIRAのOAuth 2.0アプリを作成します。
- ATLLASSIAN Developer Consoleにアクセスします。
連携したいJIRA Service Management上のアカウントでDeveloper Consoleにアクセスする必要があります。
- ダッシュボード上で［Create］→［OAuth 2.0 integration］をクリックします。
- 「Name」フィールドにアプリ名を入力し、利用規約をチェックした上［Create］をクリックします。作成に成功すると、アプリの管理画面に移動します。
- 作成したアプリの管理画面上で［Permission］をクリックします。
- 連携に必要な認証トークンのスコープを設定します。PMPのチケットシステム連携に必要なスコープは［View Jira Service Management request data］です。まず、「Jira API」横の［Configure］をクリックします（［Add］の表示をクリックすると［Configure］に変化します）。
- 「Jira API」詳細画面の［Jira Service Management API］右側の［Edit Scopes］をクリックします。
- 表示される画面上で「View Jira Service Management request data」をチェックし、［Save］をクリックします。
- ダッシュボード左メニューの［Authorization］をクリックし、OAuth 2.0コードグラントを設定します。「OAuth 2.0 (3LO)」の［Add］をクリックします。
- 表示される画面上の「Callback URL」フィールドに、PMPのコールバックURLを入力します。JIRA Service Managementと連携する場合のコールバックURLは以下のようになります。
https://<PMPサーバーのホスト名>:<リッスンポート>/jiraAuth/saveJiraAccessToken
- コールバックURLを入力したら［Save changes］をクリックします。完了するとJira Service Management APIのauthorization URLが生成されます。
- ダッシュボード左メニューの［Settings］をクリックします。ここまでの作業が完了していると、画面上でOAuth 2.0のクレデンシャルを取得できます。「Client ID」と「Secret」の値をそれぞれコピーします。
PMP上の連携設定
「OAuth 2.0 Appの設定」で取得したJIRA Service ManagementのOAuth 2.0クレデンシャルを使用して、PMP上で連携を設定します。
- PMPに初期ユーザー「Admin」でログインします。
- ［管理］→［連携］→［チケットシステム連携］に移動し、チケットシステム連携の設定画面に移動します。「Jira Service Desk」カードの［有効化］をクリックします。
- 表示されるウインドウ内のフィールドに必要事項を入力して「有効化」をクリックします。入力事項の内容は以下の通りです。
クライアントID：「OAuth 2.0 Appの設定」で取得した「Client ID」
クライアントシークレット：「OAuth 2.0 Appの設定」で取得した「Secret」
チケットシステムURL：連携したいJira Service ManagementインスタンスのURLを「https://<サブドメイン>.atlassian.net」の形式で入力
リダイレクトURL：この連携を設定しているPMPインスタンスのURL
- Jira Service Deskカードの左上部に設定した連携を認証するためのボタンが表示されます。これをクリックします。
- Jira Service Management APIのauthorization URLへリダイレクトされます。［Accept］をクリックして認証してください。
正常に認証されると、PMPインスタンスに再度遷移します。
チケットシステムの情報設定のテスト
以下の手順で、チケットシステムの情報設定が成功し、PMPがチケットシステムから情報を取得可能な状態になっているか確認します。
- PMPに初期ユーザー「Admin」でログインします。
- ［管理］→［連携］→［チケットシステム連携］に移動し、チケットシステム連携の設定画面に移動します。
- 「チケットシステム連携」画面の「Jira Service Desk」カードの右上三点のアイコンにマウスオーバーし、［テスト設定］をクリックします。
- 「チケットID」にJira Service ManagementのチケットIDを入力します。
- ［テスト］をクリックします。
- 「出力」フィールドにチケットの情報が出力されるか確認します。
- 「出力」フィールドにチケットの情報が出力されることが確認できた場合は、「チケットシステムを連携して特権IDの利用申請、承認プロセスを高度化する」の「2. 判定条件の設定」に進みます。「出力」フィールドにチケットの情報が出力されない場合は、サポートにお問い合わせください。
PMPとJira Service Managementの連携設定方法は以上です。