セキュリティー統合のための GitLab の設定

手順

1. ログインしてソースリポジトリーに移動します。
2. Setting メニューを展開し、CI/CD を選択します。
3. 変数セクションで、Expand を選択し、Add variable を選択します。
4. Flags の下で、Mask variable チェックボックスをオンにします。
5. Key フィールドに MY_GITLAB_TOKEN と入力します。
6. Value フィールドに、GitLab アカウントに関連付けられているトークンを入力します。

7. 手順 3 - 6 を繰り返して、必要な変数を追加します。

   Expand

   変数	説明
   すべてのパイプライン実行に必要な変数
   QUAY_IO_CREDS_USR	Quay.io 認証情報にアクセスするためのユーザー名。
   QUAY_IO_CREDS_PSW	Quay.io 認証情報にアクセスするためのパスワード。
   REKOR_HOST	Rekor サーバーの URL。
   TUF_MIRROR	TUF サービスの URL。
   ACS タスクに必要な変数
   ROX_CENTRAL_ENDPOINT	ROX Central サーバーのエンドポイント。
   ROX_API_TOKEN	ROX サーバーにアクセスするための API トークン。
   SBOM タスクに必要な変数
   COSIGN_SECRET_PASSWORD	Cosign 署名鍵のパスワード。
   COSIGN_SECRET_KEY	Cosign の秘密鍵。
   COSIGN_PUBLIC_KEY	Cosign の公開鍵。
   TRUSTIFICATION_BOMBASTIC_API_URL	SBOM 生成で使用される Trustification Bombastic API の URL。
   TRUSTIFICATION_OIDC_ISSUER_URL	Trustification Bombastic API と対話する際の認証に使用される OIDC 発行者 URL。
   TRUSTIFICATION_OIDC_CLIENT_ID	OIDC を使用して Trustification Bombastic API に認証するためのクライアント ID。
   TRUSTIFICATION_OIDC_CLIENT_SECRET	Trustification Bombastic API への認証にクライアント ID と一緒に使用されるクライアントシークレット。
   TRUSTIFICATION_SUPPORTED_CYCLONEDX_VERSION	システムによってサポートされ生成される CycloneDX SBOM バージョンを指定します。

   Show more

8. 最後に実行したパイプラインを再実行します。

   1. または、GitLab でアプリケーションのソースリポジトリーに切り替えて、小さな変更を加え、コミットして新しいパイプラインの実行をトリガーします。

手順

1. 次の 2 つのファイルを含むプロジェクトを作成します。

   • env_vars.sh
   • glab-set-vars

2. 次の環境変数を使用して env_vars.sh ファイルを更新します。

   # env_vars.sh
   
   # GitLab credentials
   export MY_GITLAB_TOKEN="your_gitlab_token_here"
   export MY_GITLAB_USER="your_gitlab_username_here"
   
   # ROX variables
   export ROX_CENTRAL_ENDPOINT="your_rox_central_endpoint_here"
   export ROX_API_TOKEN="your_rox_api_token_here"
   
   # Quay.io credentials
   export QUAY_IO_CREDS_USR="your_quay_username_here"
   export QUAY_IO_CREDS_PSW="your_quay_password_here"
   
   # Cosign secrets
   export COSIGN_SECRET_PASSWORD="your_cosign_secret_password_here"
   export COSIGN_SECRET_KEY="your_cosign_secret_key_here"
   export COSIGN_PUBLIC_KEY="your_cosign_public_key_here"
   
   # Rekor and TUF routes
   export REKOR_HOST="your rekor server url here"
   export TUF_MIRROR="your tuf service url here"

   Copy to Clipboard Toggle word wrap

3. 次の情報を使用して glab-set-vars ファイルを更新します。

   #!/bin/bash
   SCRIPTDIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" > /dev/null 2>&1 && pwd)"
   
   if [ $# -ne 1 ]; then
       echo "Missing param, provide gitlab repo name"
       echo "Note: This script uses MY_GITLAB_TOKEN and MY_GITLAB_USER env vars"
       exit
   fi
   
   REPO=$1
   HEADER="PRIVATE-TOKEN: $MY_GITLAB_TOKEN"
   URL=https://gitlab.com/api/v4/projects
   
   # Look up the project ID so we can use it below
   PID=$(curl -s -L --header "$HEADER" "$URL/$MY_GITLAB_USER%2F$REPO" | jq ".id")
   
   function setVars() {
       NAME=$1
       VALUE=$2
       MASKED=${3:-true}
       echo "setting $NAME in https://gitlab.com/$MY_GITLAB_USER/$REPO"
   
       # Delete first because if the secret already exists then its value
       # won't be changed by the POST below
       curl -s --request DELETE --header "$HEADER" "$URL/$PID/variables/$NAME"
   
       # Set the new key/value
       curl -s --request POST --header "$HEADER" "$URL/$PID/variables" \
           --form "key=$NAME" --form "value=$VALUE" --form "masked=$MASKED" | jq
   }
   
   setVars ROX_CENTRAL_ENDPOINT $ROX_CENTRAL_ENDPOINT false
   setVars ROX_API_TOKEN $ROX_API_TOKEN
   
   setVars GITOPS_AUTH_PASSWORD $MY_GITLAB_TOKEN
   setVars GITOPS_AUTH_USERNAME $MY_GITLAB_USER false
   
   setVars QUAY_IO_CREDS_USR $QUAY_IO_CREDS_USR false
   setVars QUAY_IO_CREDS_PSW $QUAY_IO_CREDS_PSW
   
   setVars COSIGN_SECRET_PASSWORD $COSIGN_SECRET_PASSWORD
   setVars COSIGN_SECRET_KEY $COSIGN_SECRET_KEY
   setVars COSIGN_PUBLIC_KEY $COSIGN_PUBLIC_KEY false
   
   setVars TRUSTIFICATION_BOMBASTIC_API_URL "$TRUSTIFICATION_BOMBASTIC_API_URL" false
   setVars TRUSTIFICATION_OIDC_ISSUER_URL "$TRUSTIFICATION_OIDC_ISSUER_URL" false
   setVars TRUSTIFICATION_OIDC_CLIENT_ID "$TRUSTIFICATION_OIDC_CLIENT_ID" false
   setVars TRUSTIFICATION_OIDC_CLIENT_SECRET "$TRUSTIFICATION_OIDC_CLIENT_SECRET"
   setVars TRUSTIFICATION_SUPPORTED_CYCLONEDX_VERSION "$TRUSTIFICATION_SUPPORTED_CYCLONEDX_VERSION" false
   
   setVars REKOR_HOST $REKOR_HOST false
   setVars TUF_MIRROR $TUF_MIRROR false

   Copy to Clipboard Toggle word wrap

4. 現在のシェルセッションに環境変数を読み込みます。

   source env_vars.sh

   Copy to Clipboard Toggle word wrap

5. glab-set-vars スクリプトを実行可能にし、リポジトリー名で実行して、GitLab リポジトリー内の変数を設定します。

   chmod +x glab-set-vars
   
   ./glab-set-vars your_repository_name

   Copy to Clipboard Toggle word wrap

6. 最後に実行したパイプラインを再実行します。

   1. または、GitLab でアプリケーションのソースリポジトリーに切り替えて、小さな変更を加え、コミットして新しいパイプラインの実行をトリガーします。