Jenkins について
Iru は HTTP Basic 認証を使用して Jenkins のリモート API を呼び出します。ユーザー名 と、パスワード としての API トークン(実際のパスワードよりも推奨)を使用します。ウィザードでは、まずjenkins_host(ホスト名と任意のコンテキストパスのみ)を保存してから、認証情報を入力します。
仕組み
公式リファレンス: スクリプトクライアント、API トークン、リモート API。
前提条件
- Iru のネットワーク から Jenkins に到達できること(必要に応じてファイアウォール / VPN / 許可リスト)。
- 監査対象の範囲に対して Overall/Read とジョブレベルの 読み取り アクセス権を持つユーザー。
- コントローラーには HTTPS を強く推奨します。
Jenkins を Iru に接続する
- Jenkins
- Iru Compliance
Compliance でソースを接続する前に、このタブの手順を完了してください。
1
Jenkins にサインインする
Jenkins コントローラーの URL を開き、少なくとも Overall/Read と、コンプライアンスの対象範囲に必要なジョブの読み取りアクセス権を持つユーザーでサインインします。
2
ユーザープロフィールを開く
Jenkins のテーマに応じて、右上の ユーザー名(または People リンクから自分のユーザー)を選択します。
3
構成を開く
個人設定を編集できるよう、ユーザーアカウントの 構成 を選択します。
4
API Token セクションを開く
API Token セクション(Jenkins のバージョンによっては API Token / Add new Token)までスクロールします。表示されない場合は、管理者がトークンの作成を制限している可能性があります。
5
新しいトークンを作成する
Add new Token を選択し、Iru Compliance などの名前を入力して、生成(または 作成)を選択します。Jenkins にトークンが表示されたら、一度だけ コピーします。任意で 有効期限 が適用される場合があります。Jenkins は古くなったトークンを UI に表示するため、失効する前にローテーションできます。
Iru Compliance タブに進んでください。
トラブルシューティング
ソースをオンにしても何も開かない
ソースをオンにしても何も開かない
Iru サイトの ポップアップブロッカー の設定を確認して、もう一度お試しください。
サーバー変数が失敗する
サーバー変数が失敗する
ソースをオフにしてから再度オンにし、新しいウィザードセッションを開始してください。
401 / 403
401 / 403
ユーザー/トークンを修正してください。ユーザーには対象ジョブに対する 読み取り 権限が必要です。
到達できない
到達できない
ルーティング、TLS、VPN、または Iru の送信元に対する許可リストを確認してください。
ホスト文字列が間違っている
ホスト文字列が間違っている
Jenkins がドメインのルートにない場合は、コンテキストパスを含めてください。
考慮事項
必要なフォルダにスコープされた読み取り専用のサービスユーザーを使用…
必要なフォルダやビューにスコープされた 読み取り専用 のサービスユーザーを使用してください。
関連記事
Sources の管理
すべての Compliance ソースを参照、管理します。
Compliance を使い始める
フレームワーク、アクション、アーティファクト。
Iru の概要
Endpoint、Compliance、Identity がどのように連携するか。
Artifacts の管理
ソースやアクションから得たエビデンスをアップロード、確認、整理します。
