고객 지원 분류를 위한 OpenAI API 키 보안
고객 지원 분류에 OpenAI를 안전하게 활용하는 실용적인 보안 절차를 알아보세요. API 키 보호, 로그 내 민감 정보 삭제, 권한 최소화, 자격 증명 교체, 사람의 승인 절차를 다룹니다.
요약 · TL;DR
고객 지원 분류에 OpenAI를 사용할 때는 신뢰할 수 있는 서버 측 구성 요소에 OpenAI 애플리케이션 키를 보관하고, 최소화 및 민감 정보 삭제를 거친 사례 정보만 전송하세요. 비밀 정보나 전체 대화 내용 대신 결정 사항을 기록하고, 고객에게 영향을 주는 조치는 사람이 승인하도록 하세요. 서로 다른 작업에는 최소 권한이 적용된 별도의 자격 증명을 사용하고, 키 교체 또는 폐기 절차를 문서화하세요.
핵심 요점
- 애플리케이션 API 키를 에이전트 생성 코드, 브라우저, 컨테이너 이미지, 소스 코드 관리 시스템 또는 로그에 넣지 마세요.
- 지원 사례를 모델에 보내기 전에 개인 정보와 비밀 정보를 삭제하고, 이후 보관하는 정보도 최소화하세요.
- 모델은 분류, 우선순위, 초안을 제안하는 데만 사용하세요. 사람의 승인 없이 사례를 종료하거나 환불을 처리하거나 답변을 보내지 않도록 하세요.
- 작업별로 자격 증명을 분리하고, 필요한 API 권한만 부여하며, 키 교체 및 폐기 절차를 사전에 연습하세요.
목차 (7)
가장 안전한 방식: 모델은 조언만 하고 실행은 하지 않게 하기
고객 지원 분류에서는 대개 자율적인 문제 해결보다 분류와 요약부터 시작하는 것이 유용합니다. 모델은 담당 대기열, 긴급도, 요약 초안을 제안하고, 지원 담당자는 근거를 확인한 뒤 다음 조치를 결정할 수 있습니다.
API 요청을 보내는 신뢰할 수 있는 서버 측 서비스에 OpenAI 애플리케이션 키를 보관하세요. 고객의 브라우저나 에이전트 환경에서 실행되는 코드에 키를 노출하지 마세요. OpenAI 샌드박스 보안 가이드에 따르면 에이전트 생성 코드는 해당 환경에서 사용할 수 있는 파일, 자격 증명, 네트워크 리소스에 접근할 수 있습니다. 이 가이드는 애플리케이션 키를 해당 환경 외부에 보관하고, 키를 소스 코드, 이미지 또는 로그에 삽입하지 말 것을 권장합니다. OpenAI 샌드박스 보안 안내
아래 예시는 설명을 위한 것이며, 테스트된 설정이 아닙니다. 사용하는 API 클라이언트, 개인정보 보호 요건, 지원 시스템에 맞게 조정하세요.
최소한의 분류 흐름
- 지원 시스템에서 사례를 접수하고 분류에 필요하지 않은 필드를 제거합니다.
- 신뢰할 수 있는 백엔드에서 민감한 값을 삭제한 뒤 서버 측 자격 증명을 사용해 나머지 텍스트를 OpenAI에 보냅니다.
- 모델이 제안된 분류, 우선순위, 간단한 요약을 반환합니다.
- 애플리케이션이 제안을 권한이 있는 지원 담당자에게 표시합니다. 담당자는 다음 조치를 승인하거나 수정합니다.
- 시스템은 비밀 정보를 보관하거나 전체 대화를 불필요하게 복제하지 않고, 결정 사항과 필요한 감사 메타데이터를 기록합니다.
예를 들어, 백엔드에서 의도적으로 범위를 좁힌 프롬프트와 민감 정보가 삭제된 사례를 전달할 수 있습니다. 비밀번호, 결제 카드 정보, 인증 토큰 또는 관련 없는 계정 이력은 포함하지 마세요. 로그를 나중에 작성할 때만이 아니라 요청을 보내기 전에 민감 정보 삭제 규칙을 적용해야 합니다.
# Illustrative pseudocode: provide an already-redacted case to your API client.
# Keep credential loading and the API call in a trusted backend service.
def propose_triage(api_client, redacted_case):
response = api_client.create_response(
instructions=(
"Suggest a support category, priority, and concise summary. "
"Do not claim to have resolved the case or send a reply. "
"If information is insufficient, say what is missing."
),
input=redacted_case,
)
return response
이 개요는 그대로 사용할 수 있는 OpenAI SDK 예제가 아닙니다. 메서드 이름과 요청 필드는 사용하는 클라이언트 및 API 엔드포인트에 따라 달라집니다. 구현하기 전에 현재 API 레퍼런스를 확인해 엔드포인트, 지원 매개변수, 응답 형식을 검증하세요. 모델 출력을 지원 조치의 승인으로 간주하지 마세요.
키와 권한 분리하기
가능한 경우 애플리케이션이나 작업별로 별도의 자격 증명을 사용하세요. 그러면 실수의 영향 범위를 제한하고, 관련 없는 서비스를 중단하지 않고도 특정 자격 증명을 폐기하기 쉬워집니다. 키가 필요한 시스템으로 접근을 제한하고, 관리형 비밀 정보 저장소나 이에 준하는 보호된 서버 측 시설에 키를 보관하세요. 요청을 보내는 신뢰할 수 있는 구성 요소에만 키를 전달하세요.
OpenAI 가이드에 설명된 Agents API 환경에서는 세션을 위해 애플리케이션 키에 api.agents.read 및 api.agents.write 권한이 필요하고, 추론을 위해 api.responses.write 권한이 필요합니다. Vault 관리에는 api.vaults.read 및 api.vaults.write 권한이 필요합니다. 이 가이드는 환경 키와 애플리케이션 키를 구분합니다. 환경 키는 환경 연결을 허용하며 다른 API 작업을 승인할 수 없습니다. 실제로 사용하는 API 기능에 필요한 권한만 적용하세요. Vault를 관리하지 않는 분류 서비스에는 Vault 권한을 부여하지 마세요.
에이전트 환경이나 샌드박스가 포함된다면, 그 안의 코드가 사용할 수 있는 모든 항목을 에이전트 생성 코드에 노출된 것으로 간주하세요. 서드파티 자격 증명은 환경 외부에 보관하고, 상황에 따라 신뢰할 수 있는 프록시 또는 Vault 기반 접근 방식을 사용하라고 가이드에서 권장합니다. 환경에 주입된 비밀 정보도 그 안에서 실행되는 코드가 접근할 수 있습니다.
감사 가치를 유지하면서 로그의 민감 정보 삭제하기
로그는 오분류, 접근 문제, 사고를 조사하는 데 도움이 되지만, 지원 받은 편지함을 그대로 복제한 또 다른 저장소가 되어서는 안 됩니다. API 키, 인증 헤더, 전체 프롬프트, 고객 메시지 원문 또는 민감한 세부 정보를 반복할 수 있는 모델 응답은 로그에 남기지 마세요.
내부 사례 참조 번호, 요청 시각, 모델 또는 엔드포인트 식별자, 민감 정보 삭제 상태, 제안된 분류, 사람의 결정, 오류 유형처럼 구조화되고 범위가 제한된 기록을 우선 사용하세요. 이러한 기록에도 접근 제어와 보존 기간을 적용하세요. 품질 검토를 위해 검토자가 예시 대화를 확인해야 한다면, 운영 데이터를 조용히 계속 보관하는 대신 별도의 관리 체계에 따라 데이터셋을 최소화해 만드세요.
개인 정보가 자유 형식 텍스트, 인용된 이메일 대화, 첨부 파일 또는 특이한 형식으로 나타나는 경우 민감 정보 삭제가 실패할 수 있습니다. 실제 사례를 사용해 규칙을 테스트하고, 시스템에서 어떤 정보가 나가는지 확인하며, 민감 정보를 안전하게 제거할 수 없을 때를 위한 대체 절차를 마련하세요.
키 교체 및 폐기 절차 정의하기
교체 계획에는 담당자를 지정하고, 자격 증명이 저장된 위치와 이를 사용하는 서비스, 교체 권한이 있는 사람, 변경 사항을 확인하는 방법을 명시해야 합니다. 실용적인 절차는 다음과 같습니다.
- 필요한 권한만 부여한 대체 자격 증명을 만듭니다.
- 신뢰할 수 있는 서비스의 비밀 정보 저장소를 업데이트하고, 일반적인 변경 절차에 따라 배포하거나 다시 불러옵니다.
- 진단 정보에 자격 증명을 노출하지 않고도 문제가 없는 분류 요청이 성공하는지 확인합니다.
- 이전 자격 증명을 폐기하고 서비스가 더 이상 이에 의존하지 않는지 확인합니다.
- 날짜, 담당자, 영향을 받는 작업, 결과를 기록하되 비밀 값은 기록하지 않습니다.
조직의 위험과 운영 요건에 맞춰 정기 검토 주기를 설정하세요. 노출이 의심되면 다음 정기 교체 때까지 기다리지 말고 키를 즉시 폐기하세요. OpenAI 가이드는 필요할 때 키를 교체하거나 폐기하고, 노출이 의심되면 자격 증명을 즉시 폐기하라고 명시적으로 권고합니다.
사람의 승인과 실패 처리
승인은 프롬프트에만 적어두지 말고 시스템 규칙으로 만드세요. 이 워크플로에서는 모델이 고객 메시지를 보내거나 계정 상태를 변경하거나 환불을 처리하는 도구에 직접 접근해서는 안 됩니다. 모델의 제안을 제안 사항으로 표시하고, 관련된 민감 정보 삭제 완료 근거를 보여주며, 중요한 조치는 권한이 있는 사람이 확인하도록 하세요.
API를 사용할 수 없거나 응답 형식이 잘못되었거나 민감 정보 삭제에 실패하면 기존 수동 대기열로 사례를 전달하세요. 불확실한 분류를 조용히 자동 조치로 전환하지 마세요.
체크리스트
- 애플리케이션 키는 브라우저나 에이전트 환경이 아니라 신뢰할 수 있는 백엔드에 보관합니다.
- 자격 증명은 작업별로 분리하고 필요한 권한만 부여합니다.
- 민감한 필드는 추론 전에 제거하고 일반 로그에 남기지 않습니다.
- 분류 결과는 참고용이며, 고객에게 보이거나 계정을 변경하는 조치는 사람이 승인합니다.
- 자격 증명을 교체하거나 폐기할 담당자를 지정하고, 절차를 사전에 연습합니다.
- 실패하거나 결과가 불확실하면 안전한 수동 처리 절차로 돌아갑니다.
핵심 설계 원칙은 자격 증명과 중요한 조치를 모델이 접근할 수 없는 곳에 두는 것입니다. 모델은 지원 업무를 정리하는 데 활용하고, 모델이 접하는 데이터는 최소화하며, 사람의 승인을 최종 관문으로 삼으세요.
FAQ
에이전트 샌드박스에 OpenAI API 키를 넣어도 되나요?
애플리케이션 키를 에이전트 환경에 넣지 마세요. OpenAI 샌드박스 보안 가이드에 따르면 에이전트 생성 코드는 환경의 파일, 자격 증명, 네트워크에 접근할 수 있으며, 애플리케이션 키는 환경 외부에 보관하는 것이 좋습니다. 신뢰할 수 있는 백엔드에서 API 요청을 보내세요.
고객 지원 분류 로그에는 무엇을 기록해야 하나요?
내부 사례 참조 번호, 타임스탬프, 민감 정보 삭제 상태, 제안된 분류, 사람의 결정, 오류 유형 등 운영 및 감사에 필요한 메타데이터만 기록하세요. API 키, 인증 헤더, 전체 고객 메시지, 민감한 모델 출력은 로그에 남기지 마세요.
모델이 지원 답변을 자동으로 보내도록 해야 하나요?
사람이 승인하는 분류 워크플로라면 안 됩니다. 모델 출력은 제안으로 사용하고, 고객에게 보이거나 계정을 변경하는 조치는 권한이 있는 지원 담당자가 검토하고 승인하도록 하세요.
OpenAI API 키는 언제 교체해야 하나요?
위험과 운영 요건에 맞춰 정기 검토 주기를 설정하고 필요할 때 자격 증명을 교체하세요. 노출이 의심되면 자격 증명을 즉시 폐기하고 교체 및 확인 절차를 따르세요.
관련 글
Guides
OpenAI API 장애 진단: 인증 정보를 노출하지 않는 방법
API 키를 보호하고 권한을 제한하며 인증 정보 교체를 계획하면서, 유용한 신호를 바탕으로 OpenAI API 오류를 진단하는 실용적인 가이드입니다.
Guides
문서 질의응답 워크플로에서 OpenAI API 키 안전하게 보호하기
문서 질의응답 앱을 위한 실용적인 OpenAI 보안 패턴을 알아보세요. 자격 증명을 분리하고 권한을 제한하며 로그를 마스킹하고, 출처 표기를 유지하면서 안전하게 키를 교체하는 방법을 소개합니다.
Guides
OpenAI API 인증·속도 제한·시간 초과·잘못된 응답 오류를 안전하게 진단하는 방법
인증 정보나 사용자 데이터를 노출하지 않고 OpenAI API의 인증, 요청 제한, 시간 초과, 잘못된 응답 오류를 진단하는 실용적인 개인정보 보호 가이드입니다.
Guides
고객 지원에 딱 맞는 GPT-5.6 Terra 모델: 테라가 정답인 이유
GPT-5.6 Terra가 비용, 속도, 정확성의 균형을 맞춘 고객 지원에 이상적인 모델인 이유를 알아보세요. 다른 모델과 비교하고 OneMux가 접근을 간소화하는 방법을 확인하세요.