Application Integration은 각 통합 실행에 대한 로그 메시지를 생성합니다. 이러한 로그에는 각 통합 단계의 상태를 확인하거나 실패한 통합, 작업 또는 이벤트의 문제를 해결하는 데 사용되는 정보가 포함될 수 있습니다. 하지만 로컬 로깅 또는 Cloud Logging을 사용 설정한 경우 모든 데이터 변수와 필드가 실행 로그 또는 Cloud Logging의 로그 출력에 각각 포함됩니다. 이러한 로그에는 로그 출력에 표시하지 않으려는 민감한 정보나 개인 식별 정보(PII)가 포함될 수도 있습니다. Application Integration을 사용하면 로그를 검토할 때 이 정보가 표시되지 않도록 로그 출력에서 민감한 정보를 마스킹할 수 있습니다.
혜택
로그에서 민감한 정보를 마스킹하면 다음과 같은 이점이 있습니다.
고객 보안 및 개인 정보 보호 개선
데이터 개인 정보 보호 규정 준수
지원되는 데이터 유형
Application Integration에서 지원되는 모든 데이터 유형의 변수를 마스킹할 수 있습니다.
로그에서 민감한 정보 마스킹
프로젝트의 로그에서 민감한 정보를 마스킹하려면 다음 리소스에 대해 모두 마스킹을 사용 설정해야 합니다.
프로젝트 수준 마스킹 제어는 마스킹 계층 구조의 최상위 계층을 나타내고 통합 및 변수가 그 뒤를 따릅니다. 프로젝트 수준 마스킹에 대한 승인은 리전 수준에서 플래그를 사용하여 설정됩니다. 프로젝트 수준 마스킹을 사용 설정하려면 프로젝트 내 모든 리전에 마스킹을 사용 설정하세요. 프로젝트에서 통합 및 변수에 마스킹을 사용 설정했지만 통합이 포함된 리전에 마스킹을 사용 중지한 경우 마스킹 기능이 작동하지 않습니다. 마찬가지로 통합 마스킹이 사용 중지된 경우 리전 수준에서 마스킹을 사용 설정했더라도 해당 통합의 변수 마스킹은 작동하지 않습니다.
여러 통합이 있는 리전이 포함된 프로젝트가 있다고 가정해 보겠습니다. 특정 통합의 마스킹을 사용 중지하고 싶습니다. 이 경우 리전에 마스킹을 사용 설정하고 마스킹이 필요하지 않은 특정 통합에 마스킹을 사용 중지하면 됩니다. 비즈니스 요구사항에 따라 프로젝트의 리전, 통합, 변수 수준에서 마스킹을 사용 설정할 수 있습니다. 반면 프로젝트에 여러 리전이 있고 하나의 리전에만 마스킹을 사용 설정한 경우 해당 리전과 해당 리전 내에서 빌드된 모든 통합에만 엔드 투 엔드 마스킹이 적용됩니다.
마스킹 형식
변수는 고정 마스킹 형식으로 마스킹됩니다. 예를 들어 다음 형식은 문자열 유형이고 길이가 12인 마스크 처리된 변수를 보여줍니다.
Masked String of length 12
/Masked.*\./ 정규 표현식을 사용하여 마스크 처리된 변수를 검색할 수 있습니다. 다음 정규 표현식을 사용하여 특정 유형의 마스크 처리된 변수를 필터링할 수 있습니다.
문자열: Masked String.*\.
정수: Masked Int.*\.
불리언: Masked Bool.*\.
고정 마스킹 형식은 긴 문자열에 효율적입니다. Cloud Logging과 통합 실행 로그는 동일한 형식으로 변수를 마스킹합니다.
사용 사례
고객의 판매 데이터에 연락처 정보, 주문 내역, 가격 책정 계약, 고객 결제 등 민감한 정보가 포함되어 있다고 가정해 보겠습니다. 다양한 계층 수준에서 마스킹을 사용 설정하면 데이터 로그 가시성을 보호할 수 있습니다.
프로덕션 환경에서 고객 판매를 보호하려면 프로젝트와 연결된 모든 리전에 대해 프로젝트 마스킹을 사용 설정하세요.
고객의 결제 세부정보와 같은 특정 섹션을 보호하려면 결제 흐름이 포함된 통합에 대해 마스킹을 사용 설정합니다.
고객의 계좌 번호와 같은 특정 세부정보를 보호하려면 계좌 번호가 포함된 변수에 대해 마스킹을 사용 설정합니다.
데이터 보호를 위해 모든 민감한 정보를 마스킹해야 합니다. 마스킹하지 않은 수준이 하나라도 있다면 무단 액세스의 원인이 될 수 있습니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-03(UTC)"],[[["\u003cp\u003eApplication Integration allows users to mask sensitive data in integration execution logs to enhance security and comply with data privacy regulations.\u003c/p\u003e\n"],["\u003cp\u003eMasking can be enabled at the project, integration, and variable levels, with project-level masking representing the highest level of control in the hierarchy.\u003c/p\u003e\n"],["\u003cp\u003eSensitive data masking is supported for all data types and uses a fixed format, such as \u003ccode\u003eMasked String of length 12\u003c/code\u003e, with regular expressions available for filtering.\u003c/p\u003e\n"],["\u003cp\u003eMasking sensitive data requires it to be enabled at all applicable levels, such as project, integration, and variable, as well as all regions associated with the project, or else the masking will not work.\u003c/p\u003e\n"],["\u003cp\u003eThere are no additional costs associated with masking, however it currently does not support masking data in nested fields.\u003c/p\u003e\n"]]],[],null,["# Mask sensitive data in logs\n\nSee the [supported connectors](/integration-connectors/docs/connector-reference-overview) for Application Integration.\n\nMask sensitive data in logs\n===========================\n\n|\n| **Preview\n| --- Mask sensitive data in logs**\n|\n|\n| This feature is subject to the \"Pre-GA Offerings Terms\" in the General Service Terms section\n| of the [Service Specific Terms](/terms/service-terms#1).\n|\n| Pre-GA features are available \"as is\" and might have limited support.\n|\n| For more information, see the\n| [launch stage descriptions](/products#product-launch-stages).\n\nThis document describes masking sensitive data in integration execution logs.\n\nAbout data masking\n------------------\n\nApplication Integration generates log messages for each integration execution. These logs can contain information that is used to determine the status of each integration step, or to troubleshoot failed integrations, tasks, or events. However, if you have enabled [local logging](/application-integration/docs/local-logging) or [Cloud Logging](/application-integration/docs/cloud-logging), all data variables and fields are included in the log output of the execution log or Cloud Logging respectively. These logs can also include sensitive or personally identifiable information (PII) that you don't want to be visible in the log output. With Application Integration, you can mask sensitive data in the log output so that this information is not visible when you review the logs.\n\nBenefits\n--------\n\nMasking sensitive data in logs provides the following benefits:\n\n- Improve customer security and privacy\n- Comply with data privacy regulations\n\nSupported data types\n--------------------\n\nYou can mask variables for all supported data types in Application Integration.\n\nMask sensitive data in logs\n---------------------------\n\nTo mask sensitive data in logs for a project, you must enable masking for all of the following resources:\n\n- [Project by enabling masking for all regions in that project](/application-integration/docs/enable-new-region#edit-region)\n- [Integration](/application-integration/docs/view-integration-details)\n- [Variables](/application-integration/docs/variables#create-a-variable)\n\n*Project-level* masking control signifies the highest tier of the masking hierarchy, subsequently followed by *integration* and *variables*. Authorization for project-level masking is established by using a flag at the region level. To enable project-level masking, enable masking for all regions within your projects. In your project, if you have enabled masking for the integration and the variable, but disabled masking for the region that contains the integration, then the masking functionality doesn't work. Similarly, if integration masking is disabled, variable masking for that integration doesn't work even if you have enabled masking at the region level.\n\nSuppose, you have a project that contains a region with multiple integrations. You want to disable masking for specific integration. In such a case, you can enable masking for the region and disable it for the specific integration that doesn't require masking. Based on your business needs, for your project, you can enable masking at the region, integration, and the variable level. On the other hand, if a project has multiple regions and you have enabled masking for only one region, then end-to-end masking will work only for that region and all integrations built within that region.\n\n### Masking format\n\nVariables are masked in the fixed masking format. For example, the following format shows a masked variable of type string and length 12:\n`Masked String of length 12`\n\nYou can search for masked variables with the `/Masked.*\\./` regular expression. You can use the following regular expressions to filter specific types of masked variables:\n\n- String: `Masked String.*\\.`\n- Integer: `Masked Int.*\\.`\n- Boolean: `Masked Bool.*\\.`\n\nThe fixed masking format is efficient for large strings. Both Cloud Logging and integration execution logs mask variables in the same format.\n\nExample use case\n----------------\n\nSuppose, your customers' sales data contains sensitive information such as, contact information, order history, pricing agreements, customer payments, etc. By enabling masking at different hierarchical levels, you can protect your data log visibility:\n\n- To protect customer sales in the production environment, enable masking for your project for all regions associated with that project.\n- To protect specific sections such as customer's payment details, enable masking for the intgeration that contains the payment flow.\n- To protect specific details such as customer's account number, enable masking for the variable that contains the account number.\n\nFor data protection, you must mask all sensitive information. If any level is left unmasked, it could lead to a potential point of unauthorized access.\n\nPricing\n-------\n\nThere's no additional cost for masking variables. For information about pricing, see\n[Application Integration pricing](/application-integration/pricing).\n\nLimitation\n----------\n\n- Application Integration doesn't support masking data in nested fields."]]
