Jira RESTをZeta Test Managementと接続する¶
現在のJira連携はJira REST APIを使用しています。接続はまず非本番インスタンスまたは専用のテストプロジェクトで構成およびテストしてください。ロールアウト前にJiraバージョンと必要な操作に対する具体的なサポート範囲を調整してください。
前提条件およびセキュリティモデル¶
- HTTPSでアクセス可能なJiraインスタンスの基本アドレス
- JiraプロジェクトおよびそのプロジェクトキーまたはプロジェクトID
- 最小限の権限を持つ専用の技術アカウントまたは個人用アクセストークン
- 必要なメタデータの読み取りおよび予定された操作の実行権限
- フィールド、ステータス値、コメント、および添付ファイルの承認用の代表的なテストプロジェクト
スクリーンショットやドキュメントに実際のトークンを保存しないでください。プレースホルダーを使用し、有効期限と権限を制限し、交換および失効のプロセスを設定してください。
Jira RESTの設定¶
- プロジェクト設定でバグトラッキングデータベースの設定を開き、Jiraを選択してください。
- 接続を有効にし、JiraインスタンスのHTTPSベースアドレスを入力してください。例えば
https://jira.example.orgです。コネクタはRESTパス/rest/api/2/を自動的に補完します。 - Jiraプロジェクトキーまたは必要なプロジェクトIDを入力してください。
- 詳細設定で適切な認証モードを選択し、接続をテストしてください。
Jira Cloud: APIトークンを使用したBasic認証¶
Basicを選択し、ユーザー名にAtlassianアカウントのメールアドレスを、パスワードにAtlassian APIトークンを使用してください。Jira-IsCloudJiraをtrueに設定します。通常のAtlassianパスワードはこの設定には使用しません。
Jira Data Center: 個人アクセストークンを使用したBearer認証¶
Bearerを選択し、個人用アクセストークンをセキュリティトークン欄に入力してください。コネクターはこれをBearerトークンとして送信します。個人用アクセストークンがデータセンター版およびセキュリティポリシーで許可されているか確認してください。
カスタムHTTPヘッダー¶
CustomHeaderを選択し、前段のセキュリティゲートウェイまたはターゲット環境が独自のヘッダーを要求する場合に使用してください。トークンをセキュリティトークン欄に入力し、必要に応じてJira-AuthHeaderNameおよびJira-AuthHeaderPrefixを設定してください。ヘッダー名とプレフィックスは公開されたターゲット構成から正確にコピーしてください。
モードおよびクラウド検出の技術的設定名はJira-AuthModeおよびJira-IsCloudJiraです。選択したバリアントを記録してください。ただし、秘密の値は決して記録しないでください。
認証とエラー診断¶
接続に失敗した場合は、以下の順序で確認してください:
- ベースアドレスは正しく、HTTPSでアクセス可能で、追加のRESTエンドポイントが設定されていませんか?
Jira-AuthModeは入力済みフィールドおよびJira CloudまたはData Centerに適合していますか?- APIまたはアクセストークンは有効で、期限切れでなく、取り消されていませんか?
- アカウントは対象プロジェクトおよびそのメタデータを読み取り、予定された操作を実行することが許可されていますか?
- プロジェクトキーまたはプロジェクトID、Issueタイプ、必須フィールド、ステータス値は正しいですか?
- プロキシ、ファイアウォール、DNS、およびTLS信頼関係は接続を許可していますか?
- Zetaテスト管理およびJiraのログに有効なステータスまたはエラーメッセージが含まれていますか?
複数のパラメータを同時に変更しないでください。変更時刻、秘密情報を含まない宛先アドレス、認証モード、HTTPステータス、および影響を受ける操作を記録してください。侵害されたトークンは直ちに置き換えてください。
新しいJira課題のフィールドを割り当てる¶
Zeta Test Managementで収集されたデータを、対象のJira課題タイプのフィールドに割り当てます。少なくとも概要、説明、課題タイプ、優先度、およびJiraで必須のカスタムフィールドを確認してください。クラウド設定はユーザー値の解決方法にも影響を与える場合があります。
指定された技術アカウントで選択リストおよびフィールドメタデータを読み込み、その後テスト操作を作成してください。結果はJiraで直接確認してください。コネクターおよび対象構成が確実にサポートするフィールドマッピングのみを使用してください。特にコメント、添付ファイル、カスタムフィールドは別途承認が必要です。