失敗したポスチャーチェックのためのチケットの作成

前提条件

• ユーザーにはスペースのブラウズ権限と作業項目を作成する権限があります

ステップ1: Jiraで必要な設定を構成する

Jiraの設定を構成するには：

1. あなたのAtlassianアカウントで、右上のプロフィールをクリックし、アカウント設定をクリックします。

2. セキュリティタブで、APIトークンセクションにて、APIトークンの作成と管理をクリックします。

3. APIトークンはスコープありまたはなしで作成できます。

   1. スコープありのAPIトークンを作成するには:

      1. スコープ付きAPIトークンを作成をクリックします。

      2. 名前と有効期限を追加します。
         注: 365日の最大有効期限を選択することをお勧めします。

      3. 次へ をクリックし、Jiraアプリを選択します。

      4. 次へ をクリックし、write:jira-work スコープを選択します。

      5. 作成をクリックします。

   2. スコープなしでAPIトークンを作成するには:

      1. APIトークンの作成をクリックします。

      2. 名前と有効期限を追加します。
         注: 365日の最大有効期限を選択することをお勧めします。

      3. 作成をクリックします。

4. トークンをコピーして保存し、それをCMAに入力できるようにします。

5. あなたのAtlassianアカウントで、サイドバーのスペースの横にある三点リーダーをクリックします。

6. スペースの管理をクリックします。

7. チケットを作成したいスペースのキーをコピーし保存して、CMAに入力します。

8. スコープ付きトークンを作成した場合、ウェブブラウザーでhttps://<your-site>.atlassian.net/_edge/tenant_infoにアクセスし、cloudIdの値をコピーしてCMAに入力します。
   スコープなしでトークンを作成した場合、このステップは必要ありません。

ステップ 2: CMA でのWebhookの設定

CMAでWebhookを設定するには：

1. CMAで、アカウント > サブスクリプションに移動します。

2. Webhooksタブで新規をクリックします。

3. 名前を追加します。

4. テンプレートから開始ドロップダウンメニューからJira Create Posture Check Ticketを選択します。

5. URLフィールドで：

   1. スコープ付きのAPIトークンの場合:https://api.atlassian.com/ex/jira/<cloudId>/rest/api/2/issue。ここで<cloudId>はステップ1でコピーしたcloudIdです。

   2. スコープなしのAPIトークンの場合: https://<your-site>.atlassian.net/rest/api/2/issue、ここで<your-site>はJiraサイトの名前です。

6. ステップ1でAPIトークンを作成したユーザーのユーザー名を追加します。

7. パスワードフィールドに、ステップ1で作成したAPIキーを入力します。

8. カスタムボディセクションで、<YOUR-SPACE-KEY>をステップ1でコピーしたスペースキーに置き換えます。

9. （省略可能）スペースがタスク作業タイプを使用していない場合、新しい作業アイテムに追加フィールドが必要な場合は、本文を適宜編集します。

10. テストするをクリックします。
    テスト作業アイテムがJiraスペースで作成され、メッセージ「テストが正常に完了しました」が表示されます。その後、テスト作業アイテムを削除することができます。

11. 「保存」をクリックします。

必要条件

• itilの役割を持つユーザー

ステップ 1: ServiceNowで必須設定の構成

ServiceNowでの設定手順：

1. 管理者としてServiceNowアカウントにログインし、ユーザー管理 > ユーザーに移動します。

2. 「新規」をクリックします。

3. ユーザーIDとメールアドレスを入力し、Webサービスアクセスのみを選択します。

4. 投稿をクリックします。

5. 作成したユーザーのレコードを開きます：

   1. パスワード設定をクリックし、その後パスワード生成をクリックします。パスワードをコピーして保存し、CMAに入力できるようにします。

   2. パスワード保存をクリックします。  

   3. ロールタブで編集をクリックし、itilロールを追加します

   4. 保存をクリックしてください。

ステップ 2: CMAでのWebhookの構成

CMAでのWebhook設定：

1. CMAで、アカウント > サブスクリプション に移動します。

2. Webhook タブで新規をクリックします。

3. 名前を追加します。

4. 「テンプレートから開始」ドロップダウンメニューから「サービスNow 作成ポスチャチェックチケット」を選択します。

5. URLフィールドでは、<YOUR-INSTANCE-NAME>をServiceNowのインスタンス名に置き換えて、URLがhttps://<instance>.service-now.com/api/now/table/incidentとなるようにします。

   あなたのインスタンス名は、ServiceNow URLの最初の部分です。例として、https://acme.service-now.comにログインする場合、インスタンス名はacmeで、URLはhttps://acme.service-now.com/api/now/table/incidentです。

6. ユーザー名フィールドには、ステップ1で作成したServiceNowユーザーのユーザーIDを入力します。

7. パスワードフィールドには、ステップ1で作成したServiceNowユーザーのパスワードを入力します。

8. (オプション) カスタムボディセクションで、インシデントのデフォルトの優先度、緊急度、および影響を変更するか、割り当てグループなどのフィールドを追加します。

9. テストするをクリックします。
   ServiceNowでテストインシデントが作成され、メッセージ「テストが正常に完了しました」が表示されます。その後、テスト作業項目を解決するか閉じることができます。

10. 「保存」をクリックします。

チケット作成に失敗した場合、エラーメッセージにチケットシステムから返されたステータスが表示されます:

• 401 (未認証): 資格情報が不正確であるか、トークンが期限切れです。 Webhook の ユーザー名 と パスワード フィールドを確認し、テスト をクリックします。 Jira では、ユーザーのメールアドレスと API トークンを使用します。トークンが期限切れの場合は、新しいトークンを作成し、Webhook の パスワード フィールドを更新します。

• 403 (禁止): ユーザーに必要な権限がありません。 Jira では、関連するスペースで スペースの閲覧 と 作業項目の作成 権限があることを確認します。 ServiceNow では、ユーザーが itil ロールを持っていることを確認します。

• 400 (不正要求): チケットシステムがリクエスト本文を拒否しました。カスタムボディ に不正なスペースキーや欠落している必須フィールドがないか確認します。

• チケット ID の欠落: チケットは作成されましたが、Cato がその応答から ID を読み取ることができませんでした。 Webhook の応答マッピングがテンプレートと一致していることを確認します。