62.4. ApproveVulnerabilityRequest
POST /v1/cve/requests/{id}/approve
ApproveVulnRequest는 취약점 요청을 승인합니다. 감시되지 않은 취약점 요청인 경우 관련 취약점은 정책 탐지, 위험 등 워크플로우에서 조사되지 않습니다.
62.4.1. 설명
62.4.2. 매개 변수
62.4.2.1. 경로 매개변수
이름 | 설명 | 필수 항목 | 기본 | 패턴 |
---|---|---|---|---|
id | X | null |
62.4.2.2. 본문 매개변수
이름 | 설명 | 필수 항목 | 기본 | 패턴 |
---|---|---|---|---|
body | X |
62.4.3. 반환 유형
62.4.4. 콘텐츠 유형
- application/json
62.4.5. 응답
코드 | 메시지 | datatype |
---|---|---|
200 | 성공적인 응답입니다. | |
0 | 예기치 않은 오류 응답 |
62.4.6. Samples
62.4.7. 공통 오브젝트 참조
62.4.7.1. ProtobufAny
any
는 직렬화된 메시지의 유형을 설명하는 URL과 함께 임의의 직렬화된 프로토콜 버퍼 메시지를 포함합니다.
protobuf 라이브러리는 유틸리티 함수 또는 Any 유형의 추가 생성 메서드 형태로 모든 값의 팩/unpack을 지원합니다.
예 1: 팩 및 C++에서 메시지의 압축을 풉니다.
Foo foo = ...; Any any; any.PackFrom(foo); ... if (any.UnpackTo(&foo)) { ... }
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()); }
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.
Example 3: Pack and unpack a message in Python.
foo = Foo(...) any = Any() any.Pack(foo) ... if any.Is(Foo.DESCRIPTOR): any.Unpack(foo) ...
foo = Foo(...)
any = Any()
any.Pack(foo)
...
if any.Is(Foo.DESCRIPTOR):
any.Unpack(foo)
...
Example 4: Pack and unpack a message in Go
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 { ... }
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"를 생성합니다.
62.4.7.1.1. JSON 표현
Any
값의 JSON 표현에서는 형식 URL을 포함하는 추가 필드 @type
과 함께 deserialized 포함 메시지의 정규식을 사용합니다. 예제:
package google.profile; message Person { string first_name = 1; string last_name = 2; }
package google.profile;
message Person {
string first_name = 1;
string last_name = 2;
}
{ "@type": "type.googleapis.com/google.profile.Person", "firstName": <string>, "lastName": <string> }
{
"@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" }
{
"@type": "type.googleapis.com/google.protobuf.Duration",
"value": "1.212s"
}
필드 이름 | 필수 항목 | Cryostat | 유형 | 설명 | 형식 |
---|---|---|---|---|---|
typeUrl | 문자열 |
직렬화된 프로토콜 버퍼 메시지의 유형을 고유하게 식별하는 URL/리소스 이름입니다. 이 문자열에는 하나 이상의 \"/\" 문자가 포함되어야 합니다. URL 경로의 마지막 세그먼트는 | |||
value | byte[] | 지정된 유형의 유효한 직렬화 프로토콜 버퍼여야 합니다. | byte |
62.4.7.2. RequestExpiryExpiryType
열거 값 |
---|
시간 |
ALL_CVE_FIXABLE |
ANY_CVE_FIXABLE |
62.4.7.3. RuntimeError
필드 이름 | 필수 항목 | Cryostat | 유형 | 설명 | 형식 |
---|---|---|---|---|---|
error | 문자열 | ||||
코드 | 정수 | int32 | |||
message | 문자열 | ||||
세부 정보 |
62.4.7.4. StorageApprover
필드 이름 | 필수 항목 | Cryostat | 유형 | 설명 | 형식 |
---|---|---|---|---|---|
id | 문자열 | ||||
name | 문자열 |
62.4.7.5. StorageDeferralRequest
필드 이름 | 필수 항목 | Cryostat | 유형 | 설명 | 형식 |
---|---|---|---|---|---|
만료 |
62.4.7.6. StorageDeferralUpdate
필드 이름 | 필수 항목 | Cryostat | 유형 | 설명 | 형식 |
---|---|---|---|---|---|
CVE |
| ||||
만료 |
62.4.7.7. StorageFalsePositiveUpdate
필드 이름 | 필수 항목 | Cryostat | 유형 | 설명 | 형식 |
---|---|---|---|---|---|
CVE |
|
62.4.7.8. StorageRequestComment
필드 이름 | 필수 항목 | Cryostat | 유형 | 설명 | 형식 |
---|---|---|---|---|---|
id | 문자열 | ||||
message | 문자열 | ||||
user | |||||
createdAt | 날짜 | 날짜-시간 |
62.4.7.9. StorageRequestExpiry
필드 이름 | 필수 항목 | Cryostat | 유형 | 설명 | 형식 |
---|---|---|---|---|---|
expiresWhenFixed | 부울 | 연결된 취약점이 수정될 때 이 요청이 만료됨을 나타냅니다. | |||
expiresOn | 날짜 | 이 요청이 만료되는 타임스탬프를 나타냅니다. | 날짜-시간 | ||
expiryType | TIME, ALL_CVE_FIXABLE, ANY_CVE_FIXABLE, |
62.4.7.10. StorageRequestStatus
요청 상태를 나타냅니다. 승인자가 작업하기 전에 사용자가 취소한 요청은 추적/보관되지 않습니다(설정된 경우 감사 로그를 제외하고).
- PENDING: 기본 요청 상태. 요청이 실행되지 않았으며 작업(승인/거부)이 필요함을 나타냅니다.
- APPROVED: 승인자가 요청을 승인했음을 나타냅니다.
- DeNIED: 승인자가 요청을 거부했음을 나타냅니다.
- APPROVED_PENDING_UPDATE: 원래 요청이 승인되었지만 업데이트가 승인 또는 거부를 보류 중임을 나타냅니다.
열거 값 |
---|
보류 중 |
승인됨 |
거부됨 |
APPROVED_PENDING_UPDATE |
62.4.7.11. StorageRequester
필드 이름 | 필수 항목 | Cryostat | 유형 | 설명 | 형식 |
---|---|---|---|---|---|
id | 문자열 | ||||
name | 문자열 |
62.4.7.12. StorageSlimUser
필드 이름 | 필수 항목 | Cryostat | 유형 | 설명 | 형식 |
---|---|---|---|---|---|
id | 문자열 | ||||
name | 문자열 |
62.4.7.13. StorageVulnerabilityRequest
사용 가능한 다음 태그: 30 VulnerabilityRequest는 deferral 요청 및 false-positive 요청과 같은 요청을 캡슐화합니다.
필드 이름 | 필수 항목 | Cryostat | 유형 | 설명 | 형식 |
---|---|---|---|---|---|
id | 문자열 | ||||
name | 문자열 | ||||
targetState | OBSERVED, DEFERRED, FALSE_POSITIVE, | ||||
status | 보류 중, 승인됨, 거부됨, 승인됨_PENDING_UPDATE | ||||
만료됨 | 부울 | 이 요청이 만료, 취소 또는 cve 관찰을 다시 시작하여 더 이상 적용되지 않는 기록 요청인지 나타냅니다. | |||
요청자 | |||||
승인자 | |||||
createdAt | 날짜 | 날짜-시간 | |||
lastUpdated | 날짜 | 날짜-시간 | |||
댓글 | |||||
scope | |||||
requesterV2 | |||||
approversV2 | |||||
deferralReq | |||||
fpRequest | 개체 | ||||
cves | |||||
updatedDeferralReq | |||||
deferralUpdate | |||||
falsePositiveUpdate |
62.4.7.14. StorageVulnerabilityRequestScope
필드 이름 | 필수 항목 | Cryostat | 유형 | 설명 | 형식 |
---|---|---|---|---|---|
imageScope | |||||
globalScope | 개체 |
62.4.7.15. StorageVulnerabilityState
VulnerabilityState는 취약점이 관찰되거나 지연되는지를 나타냅니다(/suppressed). 기본적으로 취약점이 발견됩니다.
열거 값 |
---|
모니터링됨 |
DEFERRED |
FALSE_POSITIVE |
62.4.7.16. V1ApproveVulnRequest
필드 이름 | 필수 항목 | Cryostat | 유형 | 설명 | 형식 |
---|---|---|---|---|---|
id | 문자열 | ||||
댓글 | 문자열 |
62.4.7.17. V1ApproveVulnRequestResponse
필드 이름 | 필수 항목 | Cryostat | 유형 | 설명 | 형식 |
---|---|---|---|---|---|
requestInfo |
62.4.7.18. VulnerabilityRequestCVEs
필드 이름 | 필수 항목 | Cryostat | 유형 | 설명 | 형식 |
---|---|---|---|---|---|
cves |
|
이는 (NVD) 취약점 식별자, |
62.4.7.19. VulnerabilityRequestScopeImage
필드 이름 | 필수 항목 | Cryostat | 유형 | 설명 | 형식 |
---|---|---|---|---|---|
레지스트리 | 문자열 | ||||
remote | 문자열 | ||||
tag | 문자열 |