証明書発行ポリシーを追加する

CA Service で証明書発行ポリシーを追加するには、認証局（CA）が発行する証明書のタイプを制御するルールと制限を定義します。証明書発行ポリシーの詳細については、証明書発行ポリシーについてをご覧ください。

証明書発行ポリシーでは、発行された証明書に含めることができるサブジェクトとサブジェクト代替名（SAN）を指定できます。証明書発行ポリシーは、CA プールの作成時に指定できます。また、既存の CA プールを更新して発行ポリシーを追加することもできます。

詳細については、テンプレートと発行ポリシーの概要をご覧ください。

準備

• CA Service オペレーション マネージャー（roles/privateca.caManager）または CA Service 管理者（roles/privateca.admin）の IAM ロールがあることを確認します。プリンシパルに IAM を付与する方法については、単一のロールを付与するをご覧ください。

• CA プールを作成します。

証明書発行ポリシーは、CA プールの作成時または既存の CA プールの更新時に CA プールに追加できます。

確認は次のいずれかの方法で行います。

サポートされている制限

CA Service は、次の発行ポリシーの制限をサポートしています。必要に応じて次の制限を組み合わせて、カスタム証明書発行ポリシーを構築できます。

許可される X.509 値を制限または適用する

CA プールでは、passthrough_extensions フィールドを構成することで、証明書リクエストで許可される X.509 値を制限できます。

CA プールでは、baseline_values フィールドを使用して、発行済みのすべての証明書に追加する X.509 値を明示的に指定し、リクエストされた値を上書きすることもできます。

CA プールの baseline_values 値を使用すると、次のプロパティを指定できます。

• 鍵の用途
• CA のオプション
• AIA OCSP サーバー
• 追加の X.509 拡張機能

これらのオプションを組み合わせて使用することもできます。

baseline_values フィールドの一部を更新すると、更新によって baseline_values フィールドの値のセット全体が置き換えられます。

• 例: 相互 TLS（mTLS）の X.509 値を使用してエンド エンティティ証明書のみを発行するように CA を制限します。

  policy.yaml

  baselineValues:
    caOptions:
      isCa: false
    keyUsage:
      baseKeyUsage:
        digitalSignature: true
        keyEncipherment: true
      extendedKeyUsage:
         clientAuth: true
         serverAuth: true
  

• 例: ベースラインの AIA OCSP URL を使用してエンド エンティティ コード署名証明書のみを発行するように CA を制限します。

  policy.yaml

  baselineValues:
    caOptions:
      isCa: false
    keyUsage:
      baseKeyUsage:
        digitalSignature: true
      extendedKeyUsage:
        codeSigning: true
    aiaOcspServers:
      -   "http://foo.bar/revocation"
    additionalExtensions:
    -   objectId:
          objectIdPath:
            -   1
            -   2
            -   3
        critical: false
        value: "base64 encoded extension value"
  

エンド エンティティ mTLS の証明書プロファイルの詳細については、エンド エンティティ mTLS をご覧ください。

許可される ID フィールドを制限する

CA プールを介して発行された証明書の ID を制限するには、発行ポリシーの identity_constraints フィールドに [Common Expression Language（CEL）][4]{: .external} 式を追加します。CEL 式を使用すると、証明書のサブジェクト ドメイン名（共通名を含む）と SAN に任意の制限を適用できます。

CEL 式を使用して Subject と SAN を制限する方法については、CEL の使用をご覧ください。

• 例: 指定されたサブジェクトに一致する証明書のみを CA が発行できるようにします。

  policy.yaml

  identityConstraints:
    allowSubjectPassthrough: true
    allowSubjectAltNamesPassthrough: false
    celExpression:
      expression: 'subject.organization == "Example LLC" && subject.country_code in ["US", "UK"]'
  

  celExpression フィールドは省略可能です。証明書が署名される前に、Common Expression Language（CEL）式を使用して、解決された X.509 サブジェクトと SAN を検証します。CEL 式の使用方法の詳細については、CEL の使用をご覧ください。

• 例: DNS 名が us.google.org であるか、.google.com で終わる SAN のみを許可します。

  policy.yaml

  identityConstraints:
    allowSubjectPassthrough: false
    allowSubjectAltNamesPassthrough: true
    celExpression:
      expression: 'subject_alt_names.all(san, san.type == DNS && (san.value == "us.google.org" || san.value.endsWith(".google.com")) )'
  

• 例: URI が https://google.com/webhp または spiffe://example-trust-domain-1/ns/namespace1/sa/ で始まる SAN のみを許可します。

  policy.yaml

  identityConstraints:
    allowSubjectPassthrough: false
    allowSubjectAltNamesPassthrough: true
    celExpression:
      expression: 'subject_alt_names.all(san, san.type == URI && (san.value == "https://google.com/webhp" || san.value.startsWith("spiffe://example-trust-domain-1/ns/namespace1/sa/")) )'
  

• 例: メールアドレスが example@google.com であるか、@google.org で終わる SAN のみを許可します。

  policy.yaml

  identityConstraints:
    allowSubjectPassthrough: false
    allowSubjectAltNamesPassthrough: true
    celExpression:
      expression: 'subject_alt_names.all(san, san.type == EMAIL && (san.value == "example@google.com" || san.value.endsWith("@google.org")) )'
  

• 例: 特定の OID とカスタム値を持つカスタム SAN のみを許可します。

  policy.yaml

  identityConstraints:
    allowSubjectPassthrough: false
    allowSubjectAltNamesPassthrough: true
    celExpression:
      expression: 'subject_alt_names.all(san, san.type == CUSTOM && san.oid == [1, 2, 3, 4] && san.value == "custom-data" )'
  

発行済み証明書のバックデート期間を制限する

発行済み証明書の過去の not_before_time を設定するには、backdate_duration フィールドを使用します。構成すると、この CA プールの証明書の not_before_time は、発行時刻から指定された期間を差し引いた値になります。not_after_time は、リクエストされた証明書の有効期間を維持するように調整されます。backdate_duration は 48 時間以下にする必要があります。

例

証明書を 1 時間遡って日付を設定するには、次の policy.yaml ファイルを使用します。

backdateDuration: 3600s

発行済み証明書の最大存続時間を制限する

発行済み証明書の有効期間を制限するには、maximum_lifetime フィールドを使用します。証明書の要求された有効期間が最大有効期間よりも長い場合、証明書の有効期間は明示的に切り捨てられます。

例

最大有効期間を 30 日にするには、次の policy.yaml ファイルを使用します。

maximumLifetime: 2592000s

許可される証明書発行モードを制限する

証明書は、証明書署名リクエスト（CSR）またはリクエストされた値のインライン説明のいずれかを使用してリクエストできます。後者の方法では関連付けられた秘密鍵の所有権の証明を必要としないため、使用できるオプションに制限を追加することを望む組織もあるかもしれません。これらの制限は、allowedIssuanceModes フィールドを使用して設定できます。

CA プールから証明書をリクエストする方法の指定について詳しくは、IssuanceModes をご覧ください。

証明書のリクエストの詳細については、証明書リクエストを作成するをご覧ください。

• 例: CSR の発行のみを許可します。

allowedIssuanceModes:
  allowCsrBasedIssuance: True
  allowConfigBasedIssuance: False

証明書リクエストの公開鍵アルゴリズムを制限する

証明書で使用できる最小鍵長と公開鍵アルゴリズムを制限するには、証明書発行ポリシーの YAML ファイルの allowedKeyTypes フィールドを使用します。このフィールドが指定されている場合、証明書リクエストの公開鍵は、YAML ファイルにリストされている鍵タイプのいずれかと一致する必要があります。このフィールドが指定されていない場合は、モジュラス サイズが 2,048 ビット未満の RSA 鍵を除き、任意の鍵を使用できます。モジュラス サイズが 2,048 ビット未満の RSA 鍵を使用する場合は、証明書発行ポリシーを使用して明示的に許可する必要があります。

例: モジュラス サイズが 3,072～4,096 ビット（両端を含む）の RSA 鍵か、NIST P-256 曲線を使用した楕円曲線の Digital Signature Algorithm（ECDSA）鍵を許可します。

allowedKeyTypes:
-   rsa:
  minModulusSize: 3072
  maxModulusSize: 4096
-   ellipticCurve:
      signatureAlgorithm: ECDSA_P256

次のいずれかの楕円曲線署名アルゴリズムを選択できます。

• EC_SIGNATURE_ALGORITHM_UNSPECIFIED - 任意の署名アルゴリズムを使用できます。
• ECDSA_P256 - NIST P-256 曲線を使用した楕円曲線デジタル署名。
• ECDSA_P384 - NIST P-384 曲線を使用した楕円曲線デジタル署名。
• EDDSA_25519 - RFC 8410 で記述されている、曲線 25519 上のエドワード曲線 Digital Signature Algorithm。

次のステップ

• 証明書プロファイルの詳細について学習する。
• 証明書のリクエストの詳細について学習する。
• IAM ポリシーの構成方法を学習する。
• Common Expression Language（CEL）を使用する方法を学習する。
• さまざまなポリシー制御を管理する方法を学習する。