이 문서에서는 콘텐츠에서 특정 메타데이터 라벨을 감지하도록 Sensitive Data Protection을 구성하는 방법을 설명합니다.
이 문서에서 메타데이터 라벨은 검사 요청에서 클라이언트 애플리케이션이 제공하는 지원되는 파일 또는 메타데이터에 삽입된 파일 라벨입니다. Sensitive Data Protection은 메타데이터 기준과 일치하는 콘텐츠를 찾으면 발견 항목을 생성합니다.
메타데이터 라벨을 스캔하려면 커스텀 메타데이터 라벨 infoType을 만듭니다. 그런 다음 해당 infoType을 검색하도록 검사 또는 탐색 스캔을 구성합니다.
장점 및 사용 사례
이 기능을 사용하면 콘텐츠 검사 및 정책 시행에 기존 분류를 사용할 수 있습니다. 문서에 메타데이터 라벨을 적용하는 커스텀 또는 서드 파티 분류 시스템을 사용하는 경우 검사 또는 탐색 작업 중에 이러한 메타데이터 라벨을 감지하도록 Sensitive Data Protection을 구성할 수 있습니다.
사용 사례의 예를 들면 다음과 같습니다.
- 특정 메타데이터가 포함된 Google Drive 라벨 또는 Microsoft 민감도 라벨이 있는지 파일을 검사합니다.
- 메타데이터 라벨 인식과 표준 infoType 인식을 결합하여 다층적인 접근 방식을 구현합니다.
- 메타데이터가 파일에 삽입되지 않은 경우에도 클라이언트 애플리케이션이 콘텐츠와 함께 전달하는 메타데이터를 스캔합니다. 이 문서에서는 이러한 유형의 메타데이터를 클라이언트 제공 메타데이터라고 합니다.
- 특정 메타데이터 라벨을 기반으로 Model Armor를 사용하여 문서를 정리합니다. Model Armor 또는 Gemini Enterprise와 같이 Model Armor를 사용하는 서비스에서 이 기능을 사용하려면 이 커스텀 메타데이터 라벨 인식 감지기를 참조하는 Model Armor에서 고급 Sensitive Data Protection 구성을 만들어야 합니다.
지원되는 메타데이터 형식
이 기능은 다음과 같은 유형의 메타데이터를 감지할 수 있습니다.
- Google Drive 라벨
다음 파일 형식의 Microsoft 민감도 라벨:
- DOCX
- PPTX
- XLSX
클라이언트 제공 메타데이터
지원되지 않는 구성
커스텀 메타데이터 라벨 인식기는 다음에서 지원되지 않습니다.
메타데이터 라벨 인식기 만들기
메타데이터 라벨 인식 프로그램을 만들려면 InspectConfig 객체 내에 CustomInfoType을 정의합니다. 스캔하려는 메타데이터 유형에 따라 다음 중 하나를 정의합니다.
- Google Drive 라벨 및 Microsoft 민감도 라벨을 스캔하려면
FileLabelInfoType를 정의합니다. 자세한 내용은 이 문서의 메타데이터 라벨 인식기를 만들어 파일 라벨 스캔을 참조하세요. - 정규 표현식을 사용하여 커스텀 키-값 쌍을 스캔하려면
MetadataKeyValueExpression를 정의합니다. 이 유형은 클라이언트 제공 메타데이터에 적합합니다. 자세한 내용은 이 문서의 키-값 쌍을 스캔하는 메타데이터 라벨 인식기 만들기를 참조하세요.
파일 라벨을 스캔하는 메타데이터 라벨 감지기 만들기
Google Drive 라벨 또는 Microsoft 민감도 라벨을 스캔하려면 FileLabelInfoType가 있는 CustomInfoType를 정의합니다. fileLabelInfoType 내에서 googleDriveLabel 또는 sensitivityLabel를 지정합니다(이러한 필드는 상호 배타적임).
Google Drive 라벨을 검사하려면 다음 안내를 따르세요.
{
"inspectConfig": {
"customInfoTypes": [
{
"infoType": {
"name": "CUSTOM_METADATA_LABEL_NAME"
},
"likelihood": "LIKELIHOOD",
"sensitivityScore": {
"score": "SENSITIVITY_SCORE"
},
"fileLabelInfoType": {
"googleDriveLabel": {
"labelId": "LABEL_ID",
"labelFieldsToMatch": [
{
"id": "FIELD_ID",
"value": "FIELD_VALUE"
}
]
}
}
}
]
}
}
Microsoft 민감도 라벨을 검사하려면 다음 안내를 따르세요.
{
"inspectConfig": {
"customInfoTypes": [
{
"infoType": {
"name": "CUSTOM_METADATA_LABEL_NAME"
},
"likelihood": "LIKELIHOOD",
"sensitivityScore": {
"score": "SENSITIVITY_SCORE"
},
"fileLabelInfoType": {
"sensitivityLabel": {
"guid": "GUID"
}
}
}
]
}
}
다음을 바꿉니다.
CUSTOM_METADATA_LABEL_NAME: 커스텀 infoType 감지기에 할당할 이름입니다.LIKELIHOOD: 선택사항. 이 커스텀 infoType과 일치하는 모든 발견 항목에 할당할Likelihood값입니다. 이 필드를 생략하면 기본 가능성 수준은VERY_LIKELY입니다.SENSITIVITY_SCORE: 선택사항. 이 커스텀 infoType과 일치하는 모든 발견 항목에 할당할SensitivityScore입니다. 이 필드를 생략하면 기본 민감도 점수는HIGH입니다.민감도 점수는 데이터 프로필에서 사용됩니다. 데이터를 프로파일링할 때 Sensitive Data Protection은 infoTypes의 민감도 점수를 사용하여 민감도 수준을 계산합니다.
LABEL_ID:googleDriveLabel를 지정할 때 필요합니다. 일치시킬 Google Drive 라벨의 ID입니다.LABEL_ID만 지정하면 감지기는 필드 값에 관계없이 해당 Google Drive 라벨이 적용된 모든 파일과 일치합니다. 라벨 내에서 특정 필드 값을 일치시키려면labelFieldsToMatch객체를 포함합니다.FIELD_ID:labelFieldsToMatch객체를 지정하는 경우 필수입니다. 일치시킬 Google Drive 라벨 필드의 ID입니다.FIELD_VALUE:labelFieldsToMatch객체를 지정하는 경우 필수입니다. 일치시킬 Google Drive 라벨 필드의 값입니다.GUID:sensitivityLabel를 지정할 때 필요합니다. 일치시킬 Microsoft 민감도 라벨의 GUID입니다.
Google Drive 라벨의 감지기 예시
이 inspectConfig 예시에서는 CUSTOM_GOOGLE_DRIVE_LABEL_CONFIDENTIAL라는 커스텀 infoType을 정의합니다. 이 커스텀 infoType은 다음이 포함된 Google Drive 라벨을 감지합니다.
- 라벨 ID
mydrive-label-id - 해당 라벨 내에서 ID가
sensitivity-field-id이고 값이confidential인 필드입니다.
labelFieldsToMatch에 필드 ID와 값을 지정하지 않으면 이 커스텀 infoType은 라벨 필드의 존재 여부와 관계없이 mydrive-label-id 라벨이 있는 파일을 감지합니다.
{
"inspectConfig": {
"customInfoTypes": [
{
"infoType": {
"name": "CUSTOM_GOOGLE_DRIVE_LABEL_CONFIDENTIAL"
},
"likelihood": "VERY_LIKELY",
"fileLabelInfoType": {
"googleDriveLabel": {
"labelId": "mydrive-label-id",
"labelFieldsToMatch": [
{
"id": "sensitivity-field-id",
"value": "confidential"
}
]
}
}
}
],
"minLikelihood": "POSSIBLE"
}
}
검사 작업에서 이 구성을 사용하면 일치 항목이 발견될 경우 Sensitive Data Protection에서 CUSTOM_GOOGLE_DRIVE_LABEL_CONFIDENTIAL 발견 항목을 생성합니다.
Microsoft 민감도 라벨의 감지기 예시
이 inspectConfig 예시에서는 CUSTOM_SENSITIVITY_LABEL_CONFIDENTIAL라는 커스텀 infoType을 정의합니다. 이 커스텀 infoType 감지기는 GUID 12345678-9012-3456-7890-123456789012가 포함된 Microsoft 민감도 라벨을 감지합니다.
{
"inspectConfig": {
"customInfoTypes": [
{
"infoType": {
"name": "CUSTOM_SENSITIVITY_LABEL_CONFIDENTIAL"
},
"likelihood": "VERY_LIKELY",
"fileLabelInfoType": {
"sensitivityLabel": {
"guid": "12345678-9012-3456-7890-123456789012"
}
}
}
],
"minLikelihood": "POSSIBLE"
}
}
검사 작업에서 이 구성을 사용하면 일치 항목이 발견될 경우 Sensitive Data Protection에서 CUSTOM_SENSITIVITY_LABEL_CONFIDENTIAL 발견 항목을 생성합니다.
커스텀 키-값 쌍을 스캔하는 메타데이터 라벨 인식기 만들기
정규 표현식을 사용하여 클라이언트 제공 메타데이터에서 커스텀 키-값 쌍을 스캔하려면 다음 단계를 따르세요.
MetadataKeyValueExpression가 있는CustomInfoType를 정의합니다.{ "inspectConfig": { "customInfoTypes": [ { "infoType": { "name": "CUSTOM_METADATA_LABEL_NAME" }, "likelihood": "LIKELIHOOD", "sensitivityScore": { "score": "SENSITIVITY_SCORE" }, "metadataKeyValueExpression": { "keyRegex": "KEY_REGULAR_EXPRESSION", "valueRegex": "VALUE_REGULAR_EXPRESSION" } } ] } }다음을 바꿉니다.
CUSTOM_METADATA_LABEL_NAME: 커스텀 infoType 감지기에 할당할 이름입니다.LIKELIHOOD: 선택사항. 이 커스텀 infoType과 일치하는 모든 발견 항목에 할당할Likelihood값입니다. 이 필드를 생략하면 기본 가능성 수준은VERY_LIKELY입니다.SENSITIVITY_SCORE: 선택사항. 이 커스텀 infoType과 일치하는 모든 발견 항목에 할당할SensitivityScore입니다. 이 필드를 생략하면 기본 민감도 점수는HIGH입니다.민감도 점수는 데이터 프로필에서 사용됩니다. 데이터를 프로파일링할 때 Sensitive Data Protection은 infoTypes의 민감도 점수를 사용하여 민감도 수준을 계산합니다.
KEY_REGULAR_EXPRESSION: 메타데이터 라벨의 키에서 검색할 정규 표현식입니다.VALUE_REGULAR_EXPRESSION: 메타데이터 라벨 값에서 검색할 정규 표현식입니다.
content.inspect요청에서ContentItem의ContentMetadata필드에 클라이언트 제공 메타데이터를 지정합니다.
클라이언트 제공 메타데이터 스캔 요청 예시
다음 예시에서는 PDF 파일과 클라이언트 제공 메타데이터가 모두 포함된 content.inspect 요청을 보여줍니다. 이 요청은 CUSTOM_METADATA_CLASSIFICATION이라는 커스텀 infoType을 사용하여 '기밀' 또는 '내부용'으로 표시된 파일을 스캔합니다.
{
"inspectConfig": {
"customInfoTypes": [
{
"infoType": {
"name": "CUSTOM_METADATA_CLASSIFICATION"
},
"likelihood": "VERY_LIKELY",
"metadataKeyValueExpression": {
"keyRegex": "classification",
"valueRegex": "Confidential|Internal Use"
}
}
]
},
"item": {
"byteItem": {
"type": "PDF",
"data": "BASE64_ENCODED_PDF"
},
"contentMetadata": {
"properties": [
{
"key": "classification",
"value": "Confidential"
}
]
}
}
}
BASE64_ENCODED_PDF을 스캔할 base64로 인코딩된 파일로 바꿉니다.
Sensitive Data Protection은 콘텐츠에서 일치 항목을 찾으면 발견 항목을 생성합니다. MetadataLocation의 발견 항목 MetadataType는 일치 항목이 파일에 삽입되었는지(CONTENT_METADATA) 또는 클라이언트에서 제공되었는지(CLIENT_PROVIDED_METADATA)에 따라 채워집니다.