プロジェクト パッケージに署名する

プロジェクト パッケージに署名する

UiPath CLI 25.10 では、パッケージの操作中にオートメーション プロジェクト パッケージにデジタル署名する機能が導入されています。パッケージの署名により、真正性を検証し、作成後にパッケージが改ざんされていないことを確認することで、CI/CD パイプラインのセキュリティが強化されます。

プロジェクト パッケージに署名すると、CLI は以下を実行します。

1. .nupkg パッケージ ファイルを作成します
2. 証明書を使用してデジタル署名を適用します
3. 必要に応じて、署名に長期的な有効性のタイムスタンプを付けます

サポートされている証明書の種類

CLI は、PKCS#12 (.pfx) 証明書形式をサポートしています。

重要:

証明書は以下を行う必要があります。

• 署名用の秘密キーを含める
• 有効であること (有効期限が切れていないこと)
• コード署名機能がある

パラメーター

package pack コマンドでは、次の署名パラメーターがサポートされています。

パラメーター	説明	Required
--certificatePath	証明書ファイル (.pfx) へのパスです。	はい(署名の場合)
--certificatePassword	証明書ファイルのパスワードです。	いいえ
--timestampServerUrl	RFC 3161 タイムスタンプ サーバーの URL です	いいえ

使用例

証明書による基本的な署名

# Windows
uipcli package pack "C:\Projects\MyRobot\project.json" `
  -o "C:\Packages" `
  --certificatePath "C:\Certificates\codesign.pfx" `
  --certificatePassword "YourPassword123"

# Linux/macOS
uipcli package pack "./MyRobot/project.json" \
  -o "./packages" \
  --certificatePath "./certificates/codesign.pfx" \
  --certificatePassword "YourPassword123"

タイムスタンプ サーバーを使用した署名

タイムスタンプを追加すると、証明書の有効期限が切れた後でも署名が有効なままになります。

uipcli package pack "./MyRobot/project.json" \
  -o "./packages" \
  --certificatePath "./certificates/codesign.pfx" \
  --certificatePassword "YourPassword123" \
  --timestampServerUrl "http://timestamp.digicert.com"

バージョンと出力タイプによる署名

uipcli package pack "./MyRobot/project.json" \
  -o "./packages" \
  -v "1.0.5" \
  --outputType "Process" \
  --certificatePath "./certificates/codesign.pfx" \
  --certificatePassword "YourPassword123" \
  --timestampServerUrl "http://timestamp.digicert.com"

パスワードレス証明書を使用した署名

uipcli package pack "./MyRobot/project.json" \
  -o "./packages" \
  --certificatePath "./certificates/codesign.pfx"

Orchestrator のライブラリ依存関係を使用して署名する

uipcli package pack "./MyRobot/project.json" \
  -o "./packages" \
  --libraryOrchestratorUrl "https://cloud.uipath.com/" \
  --libraryOrchestratorTenant "Default" \
  -A "myorg" \
  -I "becc663c-8f1e-409a-a75f-c00330d80bc8" \
  -S '********' \
  --libraryOrchestratorApplicationScope "OR.Folders OR.Execution" \
  --certificatePath "./certificates/codesign.pfx" \
  --certificatePassword "YourPassword123" \
  --timestampServerUrl "http://timestamp.digicert.com"

推奨されるタイムスタンプ サーバー

証明書の有効期限が切れた後も署名が有効であり続けるようにするには、タイムスタンプ サーバーを使用することをお勧めします。

• http://timestamp.digicert.com - デジサート
• http://timestamp.comodoca.com - セクティゴ語 (コモド)
• http://timestamp.globalsign.com - GlobalSign
• http://timestamp.sectigo.com - セクティゴ

ベスト プラクティス

セキュリティで保護された証明書ストレージ

• 証明書をバージョン管理にコミットしない
• 安全なストレージ ソリューションを使用する:
  • Azure Key Vault
  • AWS Secrets Manager
  • HashiCorp Vault
  • GitHub シークレット/Azure DevOps のセキュリティで保護されたファイル
  • CI/CD プラットフォームのシークレットの管理

環境変数

• パスワードには環境変数またはシークレット管理を使用する
• スクリプトに機密情報をハードコーディングすることは避けてください

タイムスタンプの使用状況

• 運用環境では常にタイムスタンプ サーバーを使用する
• タイムスタンプにより、証明書の有効期限を超えて署名の有効性を確保

証明書の管理

• 専用のコード署名証明書を使用する
• 有効期限が切れる前に証明書をローテーションする
• 証明書のバックアップを安全に維持する