第3章 ImageSignature [image.openshift.io/v1]
- Description
ImageSignature は、イメージの署名を保持します。署名が信頼されている限り、イメージの ID やその他の主張を検証できます。この情報に基づいて、実行可能なイメージをクラスター全体のポリシーに一致するイメージに制限することができます。必須フィールドは、イメージ検証を行うクライアントが解析する必要があります。その他は、サーバーによって署名のコンテンツから解析されます。それらは単なる有益な目的を果たします。
互換性レベル 1: メジャーリリース内で最低 12 か月または 3 つのマイナーリリース (どちらか長い方) の間安定しています。
- タイプ
-
object
- 必須
-
type
-
content
-
3.1. 仕様
プロパティー | タイプ | 説明 |
---|---|---|
|
| APIVersion はオブジェクトのこの表現のバージョンスキーマを定義します。サーバーは認識されたスキーマを最新の内部値に変換し、認識されない値は拒否することがあります。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources を参照してください。 |
|
| 条件は、シグニチャの現在の状態について利用可能な最新の観測値を表します。 |
|
| SignatureCondition は、特定のプローブ時間における特定の種類のイメージ署名条件を記述します。 |
|
| 必須: イメージの署名である不透明なバイナリー文字列。 |
| time | 指定した場合、それは署名の作成時です。 |
|
| イメージのアイデンティティを表す人間が読める文字列。製品名とバージョン、またはイメージプルスペック (例:registry.access.redhat.com/rhel7/rhel:7.2) の場合があります。 |
|
| SignatureIssuer は、署名証明書またはキーの発行者に関する情報を保持しています。 |
|
| SignatureSubject は、署名を作成した個人またはエンティティーに関する情報を保持します。 |
|
| kind はこのオブジェクトが表す REST リソースを表す文字列の値です。サーバーはクライアントが要求を送信するエンドポイントからこれを推測できることがあります。これを更新することはできません。CamelCase を使用します。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds を参照してください。 |
| metadata は標準オブジェクトのメタデータです。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata を参照してください。 | |
|
| 署名からのクレームが含まれています。 |
|
| 必須: 保存されている BLOB のタイプを記述します。 |
3.1.1. .conditions
- Description
- 条件は、シグニチャの現在の状態について利用可能な最新の観測値を表します。
- タイプ
-
array
3.1.2. .conditions[]
- Description
- SignatureCondition は、特定のプローブ時間における特定の種類のイメージ署名条件を記述します。
- タイプ
-
object
- 必須
-
type
-
status
-
プロパティー | タイプ | 説明 |
---|---|---|
| time | 前回条件がチェックされたとき。 |
| time | 前回、状態が 1 つのステータスから別のステータスに移行したとき。 |
|
| 最後にある状態から別の状態に遷移した時間。 |
|
| (簡単な) 条件の最後の遷移の理由。 |
|
| 状態のステータス、True、False、Unknown のいずれか。 |
|
| シグニチャ条件のタイプ、完了または失敗。 |
3.1.3. .issuedBy
- Description
- SignatureIssuer は、署名証明書またはキーの発行者に関する情報を保持しています。
- タイプ
-
object
プロパティー | タイプ | Description |
---|---|---|
|
| 一般名 (例:openshift-signing-service)。 |
|
| 組織名 |
3.1.4. .issuedTo
- Description
- SignatureSubject は、署名を作成した個人またはエンティティーに関する情報を保持します。
- タイプ
-
object
- 必須
-
publicKeyID
-
プロパティー | タイプ | Description |
---|---|---|
|
| 一般名 (例:openshift-signing-service)。 |
|
| 組織名 |
|
| 存在する場合、それはイメージの署名を検証するために使用されるサブジェクトに属する公開鍵の人間が読める形式の鍵 ID です。公開鍵のフィンガープリントの下位 64 ビット以上が含まれている必要があります (例:0x685ebe62bf278440)。 |