58.5. PostSignatureIntegration
POST /v1/signatureintegrations
통합 ID를 설정하지 않아야 합니다. 입력한 ID와 서명 통합을 반환합니다.
58.5.1. 설명 링크 복사링크가 클립보드에 복사되었습니다!
58.5.2. 매개 변수 링크 복사링크가 클립보드에 복사되었습니다!
58.5.2.1. 본문 매개변수 링크 복사링크가 클립보드에 복사되었습니다!
| 이름 | 설명 | 필수 항목 | 기본 | 패턴 |
|---|---|---|---|---|
| body | X |
58.5.3. 반환 유형 링크 복사링크가 클립보드에 복사되었습니다!
58.5.4. 콘텐츠 유형 링크 복사링크가 클립보드에 복사되었습니다!
- application/json
58.5.5. 응답 링크 복사링크가 클립보드에 복사되었습니다!
| 코드 | 메시지 | datatype |
|---|---|---|
| 200 | 성공적인 응답입니다. | |
| 0 | 예기치 않은 오류 응답 |
58.5.6. Samples 링크 복사링크가 클립보드에 복사되었습니다!
58.5.7. 공통 오브젝트 참조 링크 복사링크가 클립보드에 복사되었습니다!
58.5.7.1. CosignPublicKeyVerificationPublicKey 링크 복사링크가 클립보드에 복사되었습니다!
| 필드 이름 | 필수 항목 | Cryostat | 유형 | 설명 | 형식 |
|---|---|---|---|---|---|
| name | 문자열 | ||||
| publicKeyPemEnc | 문자열 |
58.5.7.2. ProtobufAny 링크 복사링크가 클립보드에 복사되었습니다!
any 는 직렬화된 메시지의 유형을 설명하는 URL과 함께 임의의 직렬화된 프로토콜 버퍼 메시지를 포함합니다.
protobuf 라이브러리는 유틸리티 함수 또는 Any 유형의 추가 생성 메서드 형태로 모든 값의 팩/unpack을 지원합니다.
예 1: 팩 및 C++에서 메시지의 압축을 풉니다.
Foo foo = ...;
Any any;
any.PackFrom(foo);
...
if (any.UnpackTo(&foo)) {
...
}
예 2: Java에서 메시지 팩 및 압축을 풉니다.
Foo foo = ...;
Any any = Any.pack(foo);
...
if (any.is(Foo.class)) {
foo = any.unpack(Foo.class);
}
// or ...
if (any.isSameTypeAs(Foo.getDefaultInstance())) {
foo = any.unpack(Foo.getDefaultInstance());
}
Example 3: Pack and unpack a message in Python.
foo = Foo(...)
any = Any()
any.Pack(foo)
...
if any.Is(Foo.DESCRIPTOR):
any.Unpack(foo)
...
Example 4: Pack and unpack a message in Go
foo := &pb.Foo{...}
any, err := anypb.New(foo)
if err != nil {
...
}
...
foo := &pb.Foo{}
if err := any.UnmarshalTo(foo); err != nil {
...
}
protobuf 라이브러리에서 제공하는 pack 메서드는 기본적으로 유형 URL로 'type.googleapis.com/full.type.name'을 사용하고 압축 해제 방법은 유형 URL에서 마지막 '/' 후에만 정규화된 유형 이름을 사용합니다(예: "foo.bar.com/x/y.z")는 유형 이름 "y.z"를 생성합니다.
58.5.7.2.1. JSON 표현 링크 복사링크가 클립보드에 복사되었습니다!
Any 값의 JSON 표현에서는 형식 URL을 포함하는 추가 필드 @type 과 함께 deserialized 포함 메시지의 정규식을 사용합니다. 예제:
package google.profile;
message Person {
string first_name = 1;
string last_name = 2;
}
{
"@type": "type.googleapis.com/google.profile.Person",
"firstName": <string>,
"lastName": <string>
}
포함된 메시지 유형이 잘 알려져 있고 사용자 지정 JSON 표현이 있는 경우 해당 표현에 @type 필드 외에도 사용자 지정 JSON이 포함된 필드 값을 추가합니다. 예(메시지 [google.protobuf.Duration][]).
{
"@type": "type.googleapis.com/google.protobuf.Duration",
"value": "1.212s"
}
| 필드 이름 | 필수 항목 | Cryostat | 유형 | 설명 | 형식 |
|---|---|---|---|---|---|
| typeUrl | 문자열 |
직렬화된 프로토콜 버퍼 메시지의 유형을 고유하게 식별하는 URL/리소스 이름입니다. 이 문자열에는 하나 이상의 \"/\" 문자가 포함되어야 합니다. URL 경로의 마지막 세그먼트는 | |||
| value | byte[] | 지정된 유형의 유효한 직렬화 프로토콜 버퍼여야 합니다. | byte |
58.5.7.3. RuntimeError 링크 복사링크가 클립보드에 복사되었습니다!
| 필드 이름 | 필수 항목 | Cryostat | 유형 | 설명 | 형식 |
|---|---|---|---|---|---|
| error | 문자열 | ||||
| 코드 | 정수 | int32 | |||
| message | 문자열 | ||||
| 세부 정보 |
58.5.7.4. StorageCosignCertificateVerification 링크 복사링크가 클립보드에 복사되었습니다!
cosign 서명에 연결된 인증서를 확인하기 위한 모든 확인 데이터가 있습니다. 인증서만 제공되면 Fulcio 신뢰할 수 있는 루트 체인으로 가정하여 에 대해 확인합니다. 체인만 제공되면 확인을 위해 Fulcio 신뢰할 수 있는 루트 체인에서 사용됩니다. 인증서 또는 체인을 제공하지 않으면 Fulcio 신뢰할 수 있는 루트 체인으로 가정하여 확인합니다.
| 필드 이름 | 필수 항목 | Cryostat | 유형 | 설명 | 형식 |
|---|---|---|---|---|---|
| certificatePemEnc | 문자열 | 확인에 사용할 PEM 인코딩 인증서입니다. | |||
| certificateChainPemEnc | 문자열 | 확인에 사용할 PEM 인코딩 인증서 체인입니다. | |||
| certificateOidcIssuer | 문자열 | 확인할 인증서 OIDC 발행자입니다. RE2 구문에 따른 정규식을 지원합니다. https://github.com/google/re2/wiki/Syntax. 인증서에서 OIDC 발행자를 지정하지 않으면 OIDC 발행자로 '.*'를 사용할 수 있습니다. 그러나 사양에 따라 Fulcio 호환 인증서를 사용하는 것이 좋습니다. https://github.com/sigstore/fulcio/blob/main/docs/certificate-specification.md. | |||
| certificateIdentity | 문자열 | 확인할 인증서 ID입니다. RE2 구문에 따른 정규식을 지원합니다. https://github.com/google/re2/wiki/Syntax. 인증서에서 ID를 지정하지 않으면 '.*'를 ID로 사용할 수 있습니다. 그러나 사양에 따라 Fulcio 호환 인증서를 사용하는 것이 좋습니다. https://github.com/sigstore/fulcio/blob/main/docs/certificate-specification.md. |
58.5.7.5. StorageCosignPublicKeyVerification 링크 복사링크가 클립보드에 복사되었습니다!
| 필드 이름 | 필수 항목 | Cryostat | 유형 | 설명 | 형식 |
|---|---|---|---|---|---|
| publicKeys |
58.5.7.6. StorageSignatureIntegration 링크 복사링크가 클립보드에 복사되었습니다!
| 필드 이름 | 필수 항목 | Cryostat | 유형 | 설명 | 형식 |
|---|---|---|---|---|---|
| id | 문자열 | ||||
| name | 문자열 | ||||
| cosign | |||||
| cosignCertificates |