baron_qa_write/docs/sso_guides/api-errors.md

# API 오류 코드와 조치

오류 응답의 `code`와 같은 항목을 찾으세요.
영문 설명은 API 오류 코드 등록부의 원문입니다.

이 문서는 오류 코드 등록부와 한국어 조치 자료에서 생성합니다.
등록부는 `backend/internal/response/error_code_registry.go`에 있습니다.
한국어 조치 자료는 `backend/cmd/error-code-registry/error_guidance.json`에 있습니다.

<a id="aal2_required"></a>

## `aal2_required`

A higher authentication assurance level is required.

현재 인증 수준이 요청에 필요한 수준에 도달하지 않았습니다.

로그인 화면에서 요구한 추가 인증을 완료해 주세요. 인증을 마치면 원래 작업 화면으로 돌아가 주세요.

<a id="access_denied"></a>

## `access_denied`

The requested operation was denied.

서버가 현재 요청의 실행을 거절했습니다. 이 코드만으로 거절한 정책을 확정할 수 없습니다.

응답의 상세 사유와 요청 대상을 확인해 주세요. 허용된 작업이 필요하면, 관리자에게 권한 검토를 요청해 주세요.

<a id="account_remediation_required"></a>

## `account_remediation_required`

The account must complete remediation before continuing.

계정에 필요한 보완 절차가 남아 있어 다음 단계로 진행할 수 없습니다.

응답이 안내한 계정 보완 화면에서 필요한 절차를 완료해 주세요. 절차를 완료할 수 없으면, 요청 식별자와 함께 지원 담당자에게 문의해 주세요.

<a id="admin_only_field"></a>

## `admin_only_field`

The field is available only to administrators.

요청에 관리자만 사용할 수 있는 필드가 포함되어 있습니다.

일반 사용자 요청에서 해당 필드를 제외해 주세요. 그 필드 변경이 필요하면, 권한이 있는 관리자에게 요청해 주세요.

<a id="ambiguous_tenant_selector"></a>

## `ambiguous_tenant_selector`

The request selects more than one tenant.

요청의 Tenant 선택 값이 하나의 대상을 가리키지 않습니다.

경로와 요청 본문의 Tenant 선택 값을 비교해 주세요. API 계약에 맞는 단일 Tenant를 지정해 주세요.

<a id="application_profile_immutable"></a>

## `application_profile_immutable`

The application profile cannot change after creation.

생성한 애플리케이션의 유형을 변경하려고 했습니다.

기존 applicationProfile 값을 유지해 주세요. 다른 유형이 필요하면, 서비스 관리자에게 별도 애플리케이션 등록을 요청해 주세요.

<a id="approval_state_unavailable"></a>

## `approval_state_unavailable`

The approval state is unavailable.

서버가 로그인 승인 상태를 조회하거나 저장하지 못했습니다. 승인 거절이나 계정 부재가 확정된 상태는 아닙니다.

승인 요청을 중복 생성하기 전에 기존 로그인 진행 상태를 확인해 주세요. 문제가 계속되면, 요청 식별자를 지원 담당자에게 전달해 주세요.

<a id="audit_unavailable"></a>

## `audit_unavailable`

The audit service is unavailable.

요청에 필요한 감사 기록 기능을 사용할 수 없습니다.

서비스 관리자에게 감사 저장소 상태 확인을 요청해 주세요. 변경 요청이면, 기존 처리 결과를 먼저 확인해 주세요.

<a id="authentication_upstream_failed"></a>

## `authentication_upstream_failed`

The authentication service failed to complete the request.

연결된 인증 서비스가 요청을 완료하지 못했습니다.

현재 로그인 상태와 응답의 다음 조치를 먼저 확인해 주세요. 문제가 계속되면, 요청 식별자를 서비스 관리자에게 전달해 주세요.

<a id="authorization_pending"></a>

## `authorization_pending`

The authorization request is waiting for user action.

사용자의 승인 등 필요한 동작이 끝나지 않아 인가 요청이 대기 중입니다.

사용자에게 표시한 승인 화면에서 필요한 동작을 완료해 주세요. 상태 조회는 서버가 안내한 간격을 지켜 주세요.

<a id="authorization_request_unavailable"></a>

## `authorization_request_unavailable`

The authorization request is unavailable.

인증 서비스가 현재 인가 요청을 사용할 수 없다고 응답했습니다. 계정이 없다는 뜻은 아닙니다.

기존 인가 요청을 다시 사용하지 마세요. 공식 서비스에서 새 로그인 절차를 시작해 주세요.

<a id="bad_gateway"></a>

## `bad_gateway`

The upstream service returned an invalid gateway response.

중간 서버가 연결된 서비스에서 유효한 응답을 받지 못했습니다.

요청 식별자로 연결 서비스와 중간 서버의 상태를 확인해 주세요. 변경 요청은 처리 결과 확인 없이 반복하지 마세요.

<a id="bad_request"></a>

## `bad_request`

The request is invalid.

요청의 형식이나 값이 해당 API의 입력 조건에 맞지 않습니다.

응답의 필드 오류와 API 요청 형식을 비교해 주세요. 지적된 값을 수정한 뒤 제출해 주세요.

<a id="bound_courier_binding_unavailable"></a>

## `bound_courier_binding_unavailable`

The bound courier binding is unavailable.

로그인 요청과 인증 메시지를 연결하는 서버 데이터를 사용할 수 없습니다.

기존 로그인 요청의 진행 상태를 먼저 확인해 주세요. 요청 식별자를 담당자에게 전달하고 연결 데이터 복구 여부를 확인해 주세요.

<a id="bound_courier_code_missing"></a>

## `bound_courier_code_missing`

The bound courier code is missing.

연결된 로그인 요청에 발송할 인증 코드가 없습니다.

같은 발송 요청을 반복하기 전에 로그인 요청 상태를 확인해 주세요. 담당자에게 인증 코드 생성 단계의 확인을 요청해 주세요.

<a id="bound_courier_expired"></a>

## `bound_courier_expired`

The bound courier request expired.

인증 메시지에 연결된 로그인 요청의 유효 시간이 지났습니다.

만료된 요청의 코드 사용을 중단해 주세요. 로그인 화면에서 새 인증 절차를 시작해 주세요.

<a id="bound_courier_identity_mismatch"></a>

## `bound_courier_identity_mismatch`

The bound courier identity does not match.

인증 메시지에 연결된 사용자와 현재 로그인 요청의 사용자가 다릅니다.

현재 로그인하려는 계정과 처음 인증을 요청한 계정을 확인해 주세요. 올바른 계정으로 로그인 절차를 다시 시작해 주세요.

<a id="bound_courier_in_progress"></a>

## `bound_courier_in_progress`

The bound courier request is already in progress.

같은 로그인 요청의 인증 메시지 처리가 이미 진행 중입니다.

현재 발송 결과를 먼저 확인해 주세요. 서버가 안내한 대기 시간이 지나기 전에는 같은 발송을 반복하지 마세요.

<a id="bound_courier_marker_invalid"></a>

## `bound_courier_marker_invalid`

The bound courier marker is invalid.

요청의 인증 메시지 연결 표식이 유효하지 않습니다.

표식을 직접 수정하지 마세요. 공식 로그인 화면에서 인증 요청을 다시 시작해 주세요.

<a id="bound_courier_recipient_mismatch"></a>

## `bound_courier_recipient_mismatch`

The bound courier recipient does not match.

인증 메시지의 수신 대상이 해당 로그인 요청에 연결된 대상과 다릅니다.

로그인 요청에 등록한 수신 대상과 현재 발송 대상을 비교해 주세요. 올바른 수신 대상으로 새 로그인 절차를 시작해 주세요.

<a id="bound_courier_replay_mismatch"></a>

## `bound_courier_replay_mismatch`

The bound courier replay does not match.

재전송 요청의 인증 코드가 기존 로그인 시도에 저장된 코드와 다릅니다.

기존 요청의 처리 상태를 먼저 확인해 주세요. 서로 다른 로그인 시도의 코드와 요청 식별자를 섞지 마세요.

<a id="bound_courier_state_invalid"></a>

## `bound_courier_state_invalid`

The bound courier state is invalid.

인증 메시지 요청의 저장 상태가 없거나 현재 처리 단계와 맞지 않습니다.

기존 요청이 완료되거나 만료되었는지 확인해 주세요. 상태가 불명확하면 요청 식별자로 담당자에게 확인을 요청해 주세요.

<a id="bound_courier_state_unavailable"></a>

## `bound_courier_state_unavailable`

The bound courier state is unavailable.

인증 메시지 처리에 필요한 서버 상태를 읽거나 저장하지 못했습니다.

메시지 수신 여부와 로그인 진행 상태를 먼저 확인해 주세요. 상태 저장소가 복구되기 전에는 발송 요청을 반복하지 마세요.

<a id="bound_courier_template_invalid"></a>

## `bound_courier_template_invalid`

The bound courier template is invalid.

발송 요청의 메시지 템플릿이 해당 인증 절차에서 허용되지 않습니다.

발송 템플릿과 로그인 절차의 종류를 비교해 주세요. 서비스 관리자에게 허용된 템플릿 구성 확인을 요청해 주세요.

<a id="bound_courier_unavailable"></a>

## `bound_courier_unavailable`

The bound courier service is unavailable.

로그인 요청에 연결된 인증 메시지 서비스를 사용할 수 없습니다.

서비스 관리자에게 메시지 서비스 구성과 연결 상태 확인을 요청해 주세요. 이미 발송 요청을 했다면 수신 여부도 먼저 확인해 주세요.

<a id="client_disabled"></a>

## `client_disabled`

The client is disabled.

요청한 애플리케이션이 비활성 상태입니다.

사용할 애플리케이션 식별자가 맞는지 확인해 주세요. 사용 재개가 필요하면, 서비스 관리자에게 검토를 요청해 주세요.

<a id="client_forbidden"></a>

## `client_forbidden`

The client is not allowed to perform this operation.

해당 애플리케이션에 현재 작업이 허용되지 않았습니다.

애플리케이션 식별자와 요청 작업을 확인해 주세요. 서비스 관리자에게 허용된 기능 범위의 검토를 요청해 주세요.

<a id="client_log_body_too_large"></a>

## `client_log_body_too_large`

The client log body exceeds the permitted size.

클라이언트 로그 요청의 본문이 허용된 크기를 초과했습니다.

로그 항목 수와 각 항목의 길이를 줄여 주세요. API가 허용한 크기로 나누어 전송해 주세요.

<a id="client_log_content_type_unsupported"></a>

## `client_log_content_type_unsupported`

The client log content type is not supported.

클라이언트 로그 요청의 Content-Type을 서버가 지원하지 않습니다.

로그 API가 요구하는 Content-Type과 본문 형식을 사용해 주세요.

<a id="client_log_origin_forbidden"></a>

## `client_log_origin_forbidden`

The client log origin is not allowed.

클라이언트 로그 요청의 출처가 허용 목록과 맞지 않습니다.

실제 서비스 주소와 허용된 출처 구성을 비교해 주세요. 관리자에게 등록 상태 확인을 요청해 주세요.

<a id="client_log_payload_invalid"></a>

## `client_log_payload_invalid`

The client log payload is invalid.

클라이언트 로그의 필드나 값이 수집 형식에 맞지 않습니다.

오류로 표시된 로그 필드를 API 형식과 비교해 주세요. 지원되지 않는 값이나 구조를 수정해 주세요.

<a id="client_log_rate_limited"></a>

## `client_log_rate_limited`

Client log requests exceed the permitted rate.

클라이언트 로그 전송 빈도가 허용량을 초과했습니다.

Retry-After가 있으면, 해당 시간 동안 기다려 주세요. 중복 로그를 줄이고 전송 간격을 늘려 주세요.

<a id="client_profile_required"></a>

## `client_profile_required`

The client profile is required for this operation.

서비스 이용 조건을 판단할 애플리케이션 프로필이 없습니다.

서비스 관리자에게 해당 애플리케이션의 프로필 등록 상태를 확인해 주세요. 프로필 문제가 해결되면 동의 절차를 다시 진행해 주세요.

<a id="conflict"></a>

## `conflict`

The request conflicts with the current resource state.

요청이 현재 자원의 상태와 충돌합니다.

자원의 최신 상태를 조회해 주세요. 변경할 내용을 다시 검토한 뒤 현재 상태에 맞는 요청을 작성해 주세요.

<a id="consent_binding_changed"></a>

## `consent_binding_changed`

Consent data changed during approval.

승인 처리 중 동의에 연결된 정보가 변경되었습니다.

기존 승인 요청을 재전송하지 마세요. 로그인부터 다시 시작하고 최신 동의 내용을 검토해 주세요.

<a id="consent_binding_persist_failed"></a>

## `consent_binding_persist_failed`

The service failed to save consent data.

서버가 승인에 필요한 동의 연결 정보를 저장하지 못했습니다.

같은 승인 요청을 재전송하지 마세요. 저장소 상태가 복구되면, 로그인부터 다시 시작해 주세요.

<a id="consent_binding_unavailable"></a>

## `consent_binding_unavailable`

Consent binding data is unavailable.

동의를 사용자와 로그인 요청에 연결하는 데이터를 사용할 수 없습니다.

담당자에게 동의 연결 데이터 상태를 확인해 주세요. 응답의 다음 조치에 따라 로그인 절차를 진행해 주세요.

<a id="consent_binding_verify_unavailable"></a>

## `consent_binding_verify_unavailable`

Consent data verification is unavailable.

서버가 승인 후 동의 연결 정보의 일치를 확인하지 못했습니다.

이미 사용한 승인 요청을 다시 보내지 마세요. 요청 식별자로 처리 상태를 확인한 뒤 로그인 절차를 새로 시작해 주세요.

<a id="consent_client_mismatch"></a>

## `consent_client_mismatch`

The consent client does not match the request.

동의 요청의 애플리케이션이 현재 로그인에 연결된 애플리케이션과 다릅니다.

처음 접속한 서비스 주소와 애플리케이션 식별자를 확인해 주세요. 올바른 서비스에서 로그인을 다시 시작해 주세요.

<a id="consent_contract_changed"></a>

## `consent_contract_changed`

The consent contract changed before approval.

승인에 필요한 동의 조건이 기존에 동의한 조건과 달라졌습니다.

최신 동의 화면에서 변경된 내용을 검토해 주세요. 필요한 동의를 완료한 뒤 요청을 새로 시작해 주세요.

<a id="consent_login_binding_missing"></a>

## `consent_login_binding_missing`

The consent login binding is missing.

동의 요청에 필요한 로그인 연결 정보가 없습니다.

서비스에서 로그인 절차를 처음부터 시작해 주세요. 기존 동의 주소를 별도 창에 복사해 사용하지 마세요.

<a id="consent_login_mismatch"></a>

## `consent_login_mismatch`

The consent login does not match the request.

동의 요청에 연결된 로그인과 현재 로그인 정보가 다릅니다.

사용 중인 계정과 로그인 창을 확인해 주세요. 같은 서비스와 계정으로 로그인 절차를 다시 시작해 주세요.

<a id="consent_missing_or_revoked"></a>

## `consent_missing_or_revoked`

Required consent is missing or revoked.

요청한 서비스를 이용할 동의가 없거나 철회되었습니다.

서비스가 제공하는 동의 절차를 시작해 주세요. 요청한 범위를 검토한 뒤 필요한 동의를 완료해 주세요.

<a id="consent_policy_denied"></a>

## `consent_policy_denied`

The sign in policy denied consent approval.

현재 로그인 정책이 동의 승인을 허용하지 않습니다.

서비스 관리자에게 거절된 정책과 사용 자격을 확인해 주세요. 정책을 충족하기 전에는 같은 승인을 반복하지 마세요.

<a id="consent_policy_unavailable"></a>

## `consent_policy_unavailable`

The sign in policy is unavailable.

서버가 동의 승인에 필요한 로그인 정책을 확인하지 못했습니다.

정책 조회 서비스가 복구되었는지 담당자에게 확인해 주세요. 복구 후 로그인부터 다시 시작해 주세요.

<a id="consent_request_invalid"></a>

## `consent_request_invalid`

The consent request is invalid or expired.

동의 승인 요청이 유효하지 않거나 만료되었습니다.

기존 승인 요청을 재전송하지 마세요. 서비스의 로그인 시작 화면에서 새 요청을 생성해 주세요.

<a id="consent_required"></a>

## `consent_required`

Required user consent is missing or revoked.

서비스 이용에 필요한 사용자 동의가 없거나 철회되었습니다.

공식 동의 화면에서 요청한 범위를 검토해 주세요. 필요한 동의를 완료한 뒤 서비스를 이용해 주세요.

<a id="consent_session_invalid"></a>

## `consent_session_invalid`

The consent session is invalid.

동의 승인에 사용한 세션이 유효하지 않습니다.

현재 서비스에서 다시 로그인해 주세요. 새 로그인에 연결된 동의 화면에서 승인해 주세요.

<a id="consent_upstream_failed"></a>

## `consent_upstream_failed`

The authentication service failed to approve consent.

연결된 인증 서비스가 동의 승인을 완료하지 못했습니다.

요청 식별자로 승인 처리 상태를 먼저 확인해 주세요. 이미 사용한 승인 요청 대신 새 로그인 절차를 시작해 주세요.

<a id="consent_upstream_rate_limited"></a>

## `consent_upstream_rate_limited`

The authentication service rate limited consent approval.

인증 서비스가 동의 승인 요청의 빈도를 제한했습니다.

Retry-After가 있으면, 안내한 시간 동안 기다려 주세요. 대기 후 로그인부터 새로 시작해 주세요.

<a id="consent_upstream_response_invalid"></a>

## `consent_upstream_response_invalid`

The authentication service returned an invalid consent response.

인증 서비스의 동의 승인 응답이 예상한 형식이나 조건에 맞지 않습니다.

승인 요청을 반복하기 전에 요청 식별자로 처리 결과를 확인해 주세요. 담당자의 확인 후 로그인부터 다시 시작해 주세요.

<a id="consent_usage_record_failed"></a>

## `consent_usage_record_failed`

The service failed to record consent usage.

승인 과정에서 동의 사용 기록을 저장하지 못했습니다.

승인 상태가 불명확하므로 요청 식별자로 처리 결과를 먼저 확인해 주세요. 기존 승인 요청을 재전송하지 마세요.

<a id="creation_audit_pending"></a>

## `creation_audit_pending`

User creation committed; audit delivery is pending. Retry with the same Idempotency-Key.

사용자는 생성됐지만 감사 저장소에 생성 기록을 전달하지 못했습니다. 서버가 원장의 최초 수행자와 대상 UUID를 유지하여 전달을 재시도합니다.

기존 Idempotency-Key로 재시도해 주세요. 새 키로 같은 사용자를 생성하지 마세요. 문제가 계속되면 서비스 관리자에게 감사 저장소 상태 확인을 요청해 주세요.

<a id="credential_conflict"></a>

## `credential_conflict`

The credential conflicts with an existing credential.

연동 자격 증명과 대화형 로그인 자격 증명이 한 요청에 함께 포함되어 있습니다.

호출할 API가 요구하는 인증 방식 하나만 사용해 주세요. 연동 API에는 브라우저 세션이나 대화형 인증 정보를 함께 보내지 마세요.

<a id="credential_create_failed"></a>

## `credential_create_failed`

The service failed to create the credential.

서버가 연동 자격 증명 생성 요청을 완료하지 못했습니다.

자격 증명 목록에서 생성 결과를 먼저 확인해 주세요. 결과가 불명확하면 요청 식별자로 관리자에게 문의해 주세요.

<a id="credential_exposure_exceeded"></a>

## `credential_exposure_exceeded`

The credential does not allow the requested exposure.

요청한 정보의 공개 수준이 자격 증명에 허용된 수준을 초과했습니다.

요청의 exposure와 자격 증명의 허용 범위를 비교해 주세요. 필요한 정보 접근은 관리자에게 별도 승인을 요청해 주세요.

<a id="credential_generation_failed"></a>

## `credential_generation_failed`

The service failed to generate the credential.

서버가 자격 증명의 비밀값을 생성하거나 안전하게 저장할 형태로 처리하지 못했습니다.

서비스 관리자에게 자격 증명 생성 기능 확인을 요청해 주세요. 임의로 비밀값을 만들어 등록하지 마세요.

<a id="credential_list_failed"></a>

## `credential_list_failed`

The service failed to list credentials.

서버가 자격 증명 목록을 조회하지 못했습니다. 목록이 비었다는 뜻은 아닙니다.

관리자에게 저장소 상태를 확인해 주세요. 서비스가 복구되면, 목록을 다시 조회해 주세요.

<a id="credential_not_active"></a>

## `credential_not_active`

The credential is not active.

작업 대상 자격 증명이 활성 상태가 아닙니다.

자격 증명의 최신 상태를 조회해 주세요. 비활성 자격 증명에 허용된 작업인지 확인해 주세요.

<a id="credential_not_found"></a>

## `credential_not_found`

The requested credential does not exist.

요청한 식별자에 해당하는 자격 증명을 찾지 못했습니다.

자격 증명 목록에서 대상 식별자를 확인해 주세요. 삭제된 대상이면, 그 식별자로 변경 요청을 보내지 마세요.

<a id="credential_not_inactive"></a>

## `credential_not_inactive`

The credential is not inactive.

비활성 이력에만 허용된 재발급을 다른 상태의 자격 증명에 요청했습니다.

자격 증명의 최신 상태와 재발급 조건을 확인해 주세요. 활성 자격 증명을 임의로 비활성화하지 마세요.

<a id="credential_operation_mismatch"></a>

## `credential_operation_mismatch`

The credential does not grant the requested operation.

자격 증명에 연결된 OperationID가 요청한 작업과 다릅니다.

요청 경로와 자격 증명의 OperationID를 비교해 주세요. 담당 관리자에게 필요한 작업 전용 자격 증명을 요청해 주세요.

<a id="credential_operation_not_available"></a>

## `credential_operation_not_available`

The requested credential operation is unavailable.

요청한 작업이 연동 자격 증명으로 사용할 수 있는 작업 목록에 없습니다.

공개 연동 API의 지원 작업 목록을 확인해 주세요. 지원되지 않는 관리자 API를 연동 키로 호출하지 마세요.

<a id="credential_scope_exceeded"></a>

## `credential_scope_exceeded`

The requested scope exceeds the credential scope.

대상 Tenant가 연동 자격 증명에 허용된 범위를 벗어났습니다.

대상 Tenant와 자격 증명의 scope를 비교해 주세요. 다른 범위 접근이 필요하면, 관리자에게 검토를 요청해 주세요.

<a id="credential_store_unavailable"></a>

## `credential_store_unavailable`

The credential store is unavailable.

연동 자격 증명을 조회하는 저장소를 사용할 수 없습니다. 키의 유효성을 판정한 결과가 아닙니다.

저장소 연결 상태를 담당자에게 확인해 주세요. 이 오류만으로 기존 키를 교체하지 마세요.

<a id="credential_update_failed"></a>

## `credential_update_failed`

The service failed to update the credential.

자격 증명 변경 요청의 저장을 완료하지 못했습니다.

목록에서 대상 자격 증명의 현재 상태를 먼저 확인해 주세요. 변경 결과가 불명확하면 요청 식별자로 문의해 주세요.

<a id="credential_usage_record_failed"></a>

## `credential_usage_record_failed`

The service failed to record credential usage.

서버가 연동 자격 증명 사용 기록을 남기지 못했습니다.

감사 기록 저장소 상태를 담당자에게 확인해 주세요. 변경 요청이면, 실제 자원 상태를 확인한 뒤 후속 조치를 결정해 주세요.

<a id="cursor_expired"></a>

## `cursor_expired`

The cursor expired.

다음 페이지를 조회하는 cursor의 유효 시간이 지났습니다.

기존 cursor를 제거하고 첫 페이지부터 다시 조회해 주세요.

<a id="cursor_invalid"></a>

## `cursor_invalid`

The cursor is invalid.

다음 페이지 조회용 cursor가 유효한 서버 발급 값이 아닙니다.

cursor를 직접 수정하지 마세요. 첫 페이지 응답이 제공한 값을 사용해 주세요.

<a id="cursor_mismatch"></a>

## `cursor_mismatch`

The cursor does not match the request.

cursor가 현재 요청에 필요한 연결 조건과 맞지 않습니다.

처음 조회한 요청 조건을 확인해 주세요. 조건을 바꿨으면, cursor 없이 첫 페이지부터 조회해 주세요.

<a id="cursor_query_mismatch"></a>

## `cursor_query_mismatch`

The cursor query does not match the request.

cursor를 발급할 때 사용한 검색 조건과 현재 조건이 다릅니다.

기존 검색 조건을 유지하거나 cursor 없이 변경한 조건으로 첫 페이지를 조회해 주세요.

<a id="cursor_scope_mismatch"></a>

## `cursor_scope_mismatch`

The cursor scope does not match the request.

cursor를 발급한 권한 범위와 현재 조회 범위가 다릅니다.

현재 허용된 Tenant 범위를 확인해 주세요. 다른 범위의 cursor를 재사용하지 말고 첫 페이지부터 조회해 주세요.

<a id="cursor_unavailable"></a>

## `cursor_unavailable`

The cursor service is unavailable.

서버가 페이지 이동 정보를 처리하는 기능을 사용할 수 없습니다.

조회 서비스의 복구 여부를 담당자에게 확인해 주세요. 복구되면, 첫 페이지부터 조회를 시작해 주세요.

<a id="dependency_unavailable"></a>

## `dependency_unavailable`

A required dependency is unavailable.

요청 처리에 필요한 연결 서비스나 저장소를 사용할 수 없습니다.

응답의 상세 정보로 영향을 받은 기능을 확인해 주세요. 변경 요청이면, 기존 작업의 처리 상태를 먼저 조회해 주세요.

<a id="device_key_conflict"></a>

## `device_key_conflict`

The device key conflicts with an existing device registration.

기기 공개 키가 기존 기기 등록과 충돌합니다.

기기 등록 목록에서 같은 키의 등록 상태를 확인해 주세요. 새 등록을 반복하기 전에 기존 기기를 복구할지 담당자와 결정해 주세요.

<a id="device_not_found"></a>

## `device_not_found`

The requested device does not exist.

요청한 식별자에 해당하는 기기를 찾지 못했습니다.

현재 계정의 기기 목록에서 식별자를 확인해 주세요. 등록이 필요한 기기이면, 공식 등록 절차를 진행해 주세요.

<a id="device_proof_expired"></a>

## `device_proof_expired`

The device proof expired.

서버가 기기 증명의 만료 시각이 지났다고 판정했습니다. 이 판정만으로 기기 시계 오류를 확정할 수 없습니다.

기기와 서버의 시간 동기화 상태를 확인해 주세요. 만료된 증명 대신 현재 요청에 맞는 새 증명을 생성해 주세요.

<a id="device_proof_issued_at_future"></a>

## `device_proof_issued_at_future`

The device proof issue time is beyond the permitted future range.

기기 증명의 발급 시각이 서버 기준 허용된 미래 범위를 초과했습니다. 기기 시계가 원인인지는 추가 확인이 필요합니다.

기기와 서버의 시간 및 증명의 iat 값을 비교해 주세요. 시간 생성 로직을 확인한 뒤 새 증명을 생성해 주세요.

<a id="device_proof_issued_at_too_old"></a>

## `device_proof_issued_at_too_old`

The device proof issue time is beyond the permitted age.

기기 증명의 발급 시각이 서버가 허용하는 기간보다 오래되었습니다.

저장된 증명을 재사용하는지 확인해 주세요. 기기와 서버의 시간 상태를 확인하고 현재 요청용 증명을 생성해 주세요.

<a id="device_proof_not_yet_valid"></a>

## `device_proof_not_yet_valid`

The device proof is not valid yet.

기기 증명의 사용 시작 시각이 서버 기준 현재 시각보다 늦습니다.

증명의 nbf 값과 서버 시간을 비교해 주세요. 기기 시계와 증명 생성 로직을 확인해 주세요.

<a id="device_proof_time_claims_invalid"></a>

## `device_proof_time_claims_invalid`

The device proof time claims are missing or invalid.

기기 증명의 시간 필드가 없거나 허용된 유효 시간 조건에 맞지 않습니다.

증명의 iat와 exp 값 및 유효 시간 길이를 API 계약과 비교해 주세요. 기기 시계만 원인으로 단정하지 마세요.

<a id="device_state_conflict"></a>

## `device_state_conflict`

The device is in a state that conflicts with the requested operation.

기기의 현재 상태에서 요청한 작업을 수행할 수 없습니다.

기기 목록에서 최신 상태를 확인해 주세요. 해당 상태에 허용된 작업을 선택해 주세요.

<a id="device_version_conflict"></a>

## `device_version_conflict`

The device version does not match the expected version.

요청에 지정한 기기 버전이 서버의 최신 버전과 다릅니다.

기기 정보를 다시 조회해 주세요. 최신 버전에 대한 변경 내용을 검토한 뒤 제출해 주세요.

<a id="diagnostic_already_running"></a>

## `diagnostic_already_running`

A diagnostic job is already running on this instance.

같은 인스턴스에서 진단 작업이 이미 실행 중입니다.

기존 작업이 끝나거나 취소된 뒤 새 작업을 시작해 주세요.

<a id="diagnostic_capture_active"></a>

## `diagnostic_capture_active`

Another diagnostic capture is active on this instance.

같은 인스턴스에서 스택 또는 진단 수집이 진행 중입니다.

진행 중인 수집이 끝난 뒤 다시 시도해 주세요.

<a id="diagnostics_disabled"></a>

## `diagnostics_disabled`

Performance diagnostics are disabled on this instance.

현재 인스턴스의 진단 실행이 허용되지 않았습니다.

비운영 환경의 진단용 빌드와 실행 플래그를 확인해 주세요. Production에서는 실행할 수 없습니다.

<a id="directory_global_scope_forbidden"></a>

## `directory_global_scope_forbidden`

Directory operations require a tenant scope.

Directory 작업에 전체 범위를 지정했지만 이 작업은 Tenant 범위만 허용합니다.

구체적인 대상 Tenant를 지정해 주세요. 그 Tenant에 허용된 연동 자격 증명을 사용해 주세요.

<a id="directory_integration_unavailable"></a>

## `directory_integration_unavailable`

The directory integration is unavailable.

Directory 연동 처리에 필요한 기능을 사용할 수 없습니다.

연동 서비스와 연결 상태를 담당자에게 확인해 주세요. 변경 요청이면, 대상 사용자와 소속의 현재 상태를 먼저 조회해 주세요.

<a id="directory_mutation_failed"></a>

## `directory_mutation_failed`

The directory operation failed.

Directory 사용자 또는 소속 변경을 완료하지 못했습니다.

대상 사용자의 현재 상태와 작업 기록을 먼저 확인해 주세요. 결과가 불명확하면 새 요청을 만들기 전에 요청 식별자로 문의해 주세요.

<a id="directory_scope_required"></a>

## `directory_scope_required`

A tenant scope is required for this directory operation.

Directory 작업에 필요한 tenant\_subtree 범위가 지정되지 않았습니다.

연동 자격 증명의 scope.kind와 scope.tenantId를 확인해 주세요. 담당 관리자에게 대상 Tenant로 한정된 자격 증명을 요청해 주세요.

<a id="expected_revision_required"></a>

## `expected_revision_required`

The current profile revision is required.

수정 요청에 현재 revision이 없습니다.

프로필 조회 응답의 revision을 expectedRevision으로 전달해 주세요.

<a id="expired_token"></a>

## `expired_token`

The token expired.

요청에 사용한 토큰 또는 인증 코드의 유효 시간이 지났습니다.

만료된 값을 재사용하지 마세요. 해당 로그인 또는 인증 절차에서 새 값을 발급받아 주세요.

<a id="export_too_large"></a>

## `export_too_large`

The export exceeds the permitted size.

내보내기 대상이 허용된 크기나 건수를 초과했습니다.

조회 기간과 대상 범위를 줄여 주세요. 필요한 결과를 허용된 범위로 나누어 내보내 주세요.

<a id="forbidden"></a>

## `forbidden`

The authenticated principal is not allowed to perform this operation.

인증한 주체에 요청 작업을 수행할 권한이 없습니다.

대상 자원과 현재 권한 범위를 확인해 주세요. 업무상 필요한 권한은 승인 절차로 요청해 주세요.

<a id="fresh_totp_required"></a>

## `fresh_totp_required`

A fresh TOTP authentication is required.

현재 작업에 사용할 만큼 최근에 수행한 TOTP 인증 기록이 없습니다.

로그인 화면에서 시간 기반 일회용 코드인 TOTP로 다시 인증해 주세요. 인증 후 원래 작업으로 돌아가 주세요.

<a id="gateway_timeout"></a>

## `gateway_timeout`

The upstream service did not respond in time.

연결된 서비스가 제한 시간 안에 응답하지 않았습니다. 작업 미실행이나 실패가 확정된 상태는 아닙니다.

기존 작업 상태와 대상 자원을 먼저 조회해 주세요. 재전송이 필요하면, API의 중복 방지 규칙과 기존 Idempotency-Key를 유지해 주세요.

<a id="hanmac_email_local_part_conflict"></a>

## `hanmac_email_local_part_conflict`

The Hanmac email local part conflicts with another account.

Hanmac 이메일에서 @ 앞부분이 다른 계정과 충돌합니다.

해당 이메일 식별자를 사용하는 기존 계정을 확인해 주세요. 다른 계정의 식별자를 덮어쓰지 말고 관리자에게 조정을 요청해 주세요.

<a id="headless_jwks_refresh_failed"></a>

## `headless_jwks_refresh_failed`

The headless login key set refresh failed.

화면 없는 로그인에 사용하는 공개 키 집합을 갱신하지 못했습니다.

서비스 관리자에게 등록한 JWKS 주소의 응답과 키 게시 상태를 확인해 주세요. 키 검증을 생략하지 마세요.

<a id="hr_integration_unavailable"></a>

## `hr_integration_unavailable`

HR integration is unavailable.

HR 연동에 필요한 서비스가 응답하지 않습니다.

잠시 후 같은 Idempotency-Key로 다시 요청해 주세요.

<a id="hr_tenant_scope_required"></a>

## `hr_tenant_scope_required`

HR operations require a hanmac-family tenant subtree.

HR 키의 조직 범위가 hanmac-family 하위 조직이 아닙니다.

hanmac-family 하위의 구체적인 조직을 선택해 키를 발급해 주세요.

<a id="id_token_claims_invalid"></a>

## `id_token_claims_invalid`

The identity token claims are invalid.

ID token에 넣을 사용자 정보 필드의 구성이 허용된 조건에 맞지 않습니다.

metadata.id\_token\_claims.top\_level 값과 허용된 필드 구성을 확인해 주세요. 서비스 관리자에게 토큰 정보 구성의 수정을 요청해 주세요.

<a id="idempotency_conflict"></a>

## `idempotency_conflict`

The idempotency key is already bound to a different request.

같은 Idempotency-Key가 다른 요청 내용에 이미 연결되어 있습니다.

해당 키로 처음 보낸 요청과 처리 상태를 먼저 확인해 주세요. 재시도이면, 처음 보낸 본문과 같은 키를 유지해 주세요. 독립된 새 작업일 때만 새 키를 사용해 주세요.

<a id="idempotency_key_required"></a>

## `idempotency_key_required`

An idempotency key is required for this operation.

중복 실행을 구분할 Idempotency-Key가 요청에 없습니다.

하나의 작업에 사용할 고유한 Idempotency-Key를 지정해 주세요. 같은 작업을 재전송할 때는 같은 키와 본문을 유지해 주세요.

<a id="identifier_conflict"></a>

## `identifier_conflict`

A login identifier is already in use.

전화번호 등 로그인 식별자를 다른 사용자가 사용하고 있습니다.

다른 사용자의 식별자와 겹치지 않는 값으로 수정해 주세요.

<a id="identity_lookup_failed"></a>

## `identity_lookup_failed`

The service failed to look up the identity.

서버가 사용자 원장 조회를 완료하지 못했습니다. 사용자가 없다는 판정은 아닙니다.

사용자 식별자와 요청 식별자를 기록해 주세요. 담당자에게 원장 조회 상태를 확인한 뒤 조회를 진행해 주세요.

<a id="identity_lookup_unavailable"></a>

## `identity_lookup_unavailable`

The identity lookup service is unavailable.

사용자 원장을 조회하는 서비스를 사용할 수 없습니다.

원장 서비스의 연결 상태를 담당자에게 확인해 주세요. 조회 실패를 근거로 사용자를 새로 만들거나 삭제하지 마세요.

<a id="identity_mirror_unavailable"></a>

## `identity_mirror_unavailable`

The identity mirror is unavailable.

사용자 원장을 복제한 조회 데이터를 사용할 수 없습니다.

담당자에게 복제 데이터의 저장소와 동기화 상태를 확인해 주세요. 사용자 부재로 판단하지 마세요.

<a id="identity_visibility_unavailable"></a>

## `identity_visibility_unavailable`

Identity visibility data is unavailable.

사용자 노출 범위를 판단하는 데이터를 사용할 수 없습니다.

담당자에게 노출 정책 조회 상태를 확인해 주세요. 정책 확인 없이 사용자 정보를 다른 경로로 조회하지 마세요.

<a id="import_preview_changed"></a>

## `import_preview_changed`

The import preview changed before submission.

가져오기 미리보기와 제출 시점의 대상 데이터가 달라졌습니다.

가져오기 미리보기를 새로 생성해 주세요. 변경된 대상과 결과를 검토한 뒤 제출해 주세요.

<a id="incomparable_performance_runs"></a>

## `incomparable_performance_runs`

The measurements do not satisfy the performance comparison requirements.

측정 조건이 다르거나 정상 실행의 표본 조건을 만족하지 않습니다.

환경, fixture, 동시성, 측정 항목, 워밍업, 오류 수와 진단 플래그를 확인해 주세요.

<a id="inline_headless_jwks_not_allowed"></a>

## `inline_headless_jwks_not_allowed`

Inline headless login keys are not allowed.

요청 본문에 직접 포함한 headless 로그인 공개 키를 허용하지 않습니다.

API가 요구하는 공개 키 등록 방식을 확인해 주세요. 서비스 관리자에게 허용된 키 배포 경로 구성을 요청해 주세요.

<a id="installed_refresh_policy_not_allowed"></a>

## `installed_refresh_policy_not_allowed`

The installed refresh policy does not allow this operation.

애플리케이션 유형이 요청한 설치형 앱 갱신 정책을 허용하지 않습니다.

applicationProfile과 installedAppRefreshPolicy의 허용 조합을 확인해 주세요. 서버 간 통신용 애플리케이션에 설치형 앱 정책을 지정하지 마세요.

<a id="integration_credential_expired"></a>

## `integration_credential_expired`

The integration credential expired.

연동 자격 증명의 만료 시간이 지났습니다.

관리자에게 승인된 갱신 또는 재발급 절차를 요청해 주세요. 새 자격 증명을 적용하기 전에 사용 범위를 확인해 주세요.

<a id="integration_credential_not_allowed"></a>

## `integration_credential_not_allowed`

The integration credential is not allowed.

현재 경로는 연동 자격 증명을 인증 수단으로 허용하지 않습니다.

연동 작업에는 공개된 /integrations/\* 경로를 사용해 주세요. 관리자 작업은 권한이 있는 사용자의 대화형 인증으로 진행해 주세요.

<a id="integration_credential_required"></a>

## `integration_credential_required`

An integration credential is required.

연동 API에 필요한 키 식별자나 비밀값이 없습니다.

X-Baron-Key-ID와 X-Baron-Key-Secret 헤더의 전달 여부를 확인해 주세요. 비밀값을 로그나 오류 보고에 넣지 마세요.

<a id="interactive_client_credentials_not_allowed"></a>

## `interactive_client_credentials_not_allowed`

Interactive clients cannot use client credentials.

대화형 애플리케이션이 client\_credentials 방식을 요청했습니다.

애플리케이션의 실제 사용 목적과 grantTypes를 확인해 주세요. 서버 간 통신이 필요하면, 별도 m2m 애플리케이션 등록을 담당자에게 요청해 주세요.

<a id="internal_domain_personal_assignment_rejected"></a>

## `internal_domain_personal_assignment_rejected`

Internal email domains cannot be assigned to personal tenants.

내부 이메일 도메인 사용자를 Personal 테넌트에 소속시키려 했습니다.

해당 사용자의 대표 소속을 회사 또는 조직 테넌트로 지정해 주세요.

<a id="internal_error"></a>

## `internal_error`

The server failed to complete the request.

서버 내부 오류로 요청 처리를 완료하지 못했습니다.

변경 요청이면, 자원의 현재 상태를 먼저 확인해 주세요. 요청 식별자와 발생 시각을 서비스 관리자에게 전달해 주세요.

<a id="invalid_client"></a>

## `invalid_client`

The client authentication is invalid.

애플리케이션 인증 정보가 유효하지 않습니다.

client\_id와 해당 애플리케이션에 등록된 인증 방식을 확인해 주세요. 비밀값이나 서명 키의 등록 상태는 관리자에게 확인해 주세요.

<a id="invalid_client_assertion_audience"></a>

## `invalid_client_assertion_audience`

The client assertion audience does not match.

클라이언트가 서명한 인증 문서의 aud 값이 서버가 기대한 대상과 다릅니다.

등록된 토큰 발급 주소와 aud 값을 비교해 주세요. 올바른 대상을 넣어 인증 문서를 다시 생성해 주세요.

<a id="invalid_client_assertion_expired"></a>

## `invalid_client_assertion_expired`

The client assertion expiry is not valid.

클라이언트 인증 문서의 만료 조건이 유효하지 않습니다.

인증 문서의 exp 값과 서버 시간을 비교해 주세요. 허용된 유효 시간으로 새 인증 문서를 생성해 주세요.

<a id="invalid_client_assertion_iat_future"></a>

## `invalid_client_assertion_iat_future`

The client assertion issue time is not valid.

클라이언트 인증 문서의 발급 시각이 서버의 허용 범위를 벗어났습니다.

iat 값과 클라이언트 및 서버의 시간을 비교해 주세요. 시간 동기화와 발급 로직을 확인해 주세요.

<a id="invalid_client_assertion_iss_sub"></a>

## `invalid_client_assertion_iss_sub`

The client assertion issuer or subject does not match.

클라이언트 인증 문서의 iss 또는 sub 값이 등록한 클라이언트와 맞지 않습니다.

등록된 client\_id와 iss 및 sub 값을 비교해 주세요. 다른 애플리케이션의 인증 문서를 사용하지 마세요.

<a id="invalid_client_assertion_jwks_load"></a>

## `invalid_client_assertion_jwks_load`

The client assertion keys are unavailable.

클라이언트 인증 문서를 검증할 공개 키를 읽지 못했습니다.

등록된 JWKS 주소의 접근 가능 여부와 응답 형식을 확인해 주세요. 키를 읽을 수 있을 때까지 인증 검증을 우회하지 마세요.

<a id="invalid_client_assertion_not_before"></a>

## `invalid_client_assertion_not_before`

The client assertion is not active yet.

클라이언트 인증 문서를 사용할 수 있는 시작 시각이 아직 되지 않았습니다.

nbf 값과 서버 시간을 비교해 주세요. 클라이언트의 시간 상태와 인증 문서 생성 로직을 확인해 주세요.

<a id="invalid_client_assertion_parse"></a>

## `invalid_client_assertion_parse`

The client assertion format is invalid.

클라이언트 인증 문서의 형식을 해석할 수 없습니다.

API가 요구하는 서명 문서 형식과 인코딩을 확인해 주세요. 전송 과정에서 값이 잘리거나 변형되었는지 확인해 주세요.

<a id="invalid_client_assertion_signature"></a>

## `invalid_client_assertion_signature`

The client assertion signature is invalid.

클라이언트 인증 문서의 서명을 등록된 공개 키로 검증하지 못했습니다.

서명 키와 공개 키의 짝 및 kid 값을 확인해 주세요. 키 교체 중이면, 공개 키 게시가 끝났는지 확인해 주세요.

<a id="invalid_code"></a>

## `invalid_code`

The supplied authorization code is invalid.

제출한 인증 또는 인가 코드가 현재 요청에서 유효하지 않습니다.

코드를 발급한 로그인 요청과 현재 요청이 같은지 확인해 주세요. 사용했거나 만료된 코드이면, 공식 절차에서 새 코드를 발급받아 주세요.

<a id="invalid_device_proof"></a>

## `invalid_device_proof`

The device proof is invalid.

기기 서명이나 요청에 결합된 값이 검증을 통과하지 못했습니다.

기기 키, audience, 요청 hash, 발급 시각과 jti를 확인해 주세요. 같은 proof를 다시 전송하지 마세요.

<a id="invalid_email"></a>

## `invalid_email`

The email address is invalid.

이메일 값이 허용된 주소 형식에 맞지 않습니다.

이메일 주소의 형식과 입력 오류를 확인해 주세요. 오류가 표시된 필드만 수정해 주세요.

<a id="invalid_employee_number"></a>

## `invalid_employee_number`

The employee number must be a string of at most 20 characters or null.

사번의 형식 또는 길이가 올바르지 않습니다.

사번은 최대 20자의 문자열로 전달해 주세요. 삭제할 때는 null 또는 빈 문자열을 사용해 주세요.

<a id="invalid_expiry"></a>

## `invalid_expiry`

The expiry value is invalid.

요청한 만료 값이 허용된 기간이나 형식에 맞지 않습니다.

해당 API의 만료 필드 형식과 허용 범위를 확인해 주세요. 그 범위에 맞는 값을 제출해 주세요.

<a id="invalid_exposure"></a>

## `invalid_exposure`

The exposure value is invalid.

정보 공개 수준으로 허용되지 않은 값을 요청했습니다.

exposure에 허용된 structure, members, identifiers 중 필요한 값을 사용해 주세요. 자격 증명이 그 수준을 허용하는지도 확인해 주세요.

<a id="invalid_format"></a>

## `invalid_format`

The supplied value has an invalid format.

입력 값이 해당 필드에 필요한 형식과 맞지 않습니다.

응답에 표시한 필드와 요구 형식을 확인해 주세요. 값을 해당 형식으로 수정해 주세요.

<a id="invalid_grant"></a>

## `invalid_grant`

The supplied grant is invalid or unusable.

제출한 인가 코드나 갱신 수단을 현재 요청에 사용할 수 없습니다.

해당 값의 만료와 사용 이력 및 클라이언트 연결을 확인해 주세요. 로그인 재시작이 필요한 경우 공식 로그인 절차를 따라 주세요.

<a id="invalid_integration_credential"></a>

## `invalid_integration_credential`

The integration credential is invalid or inactive.

연동 자격 증명이 유효하지 않거나 활성 상태가 아닙니다.

키 식별자와 비밀값의 짝을 확인해 주세요. 관리자에게 폐기·교체·만료 상태를 확인해 주세요.

<a id="invalid_job_request"></a>

## `invalid_job_request`

The operations job request is invalid.

지원하지 않는 작업 종류나 진단 옵션입니다.

작업 종류와 CPU 수집 시간 1~30초 조건을 확인해 주세요.

<a id="invalid_json"></a>

## `invalid_json`

The request body contains invalid JSON.

요청 본문을 올바른 JSON으로 해석할 수 없습니다.

따옴표와 쉼표 등 JSON 문법을 확인해 주세요. 올바른 JSON 본문과 Content-Type을 전송해 주세요.

<a id="invalid_login_identifier"></a>

## `invalid_login_identifier`

The employee number does not satisfy the login identifier policy.

사번으로 만든 로그인 식별자가 정책을 만족하지 않습니다.

해당 조직의 로그인 식별자 정책에 맞는 사번을 전달해 주세요.

<a id="invalid_login_prepare_request"></a>

## `invalid_login_prepare_request`

The login preparation request is invalid.

로그인 준비 요청이 필요한 입력 조건에 맞지 않습니다.

공식 로그인 시작 화면에서 요청을 생성해 주세요. 연동 구현이면, 필수 필드와 허용된 요청 형식을 확인해 주세요.

<a id="invalid_membership_delta"></a>

## `invalid_membership_delta`

The membership change is invalid.

추가하거나 제거할 소속의 변경 내용이 유효하지 않습니다.

추가 목록과 제거 목록의 중복 및 대상 Tenant를 확인해 주세요. 현재 소속을 기준으로 변경 요청을 다시 작성해 주세요.

<a id="invalid_name"></a>

## `invalid_name`

The name must contain at most 100 characters.

이름이 비어 있거나 허용 길이를 초과했습니다.

제어문자 없이 1~100자의 이름을 전달해 주세요.

<a id="invalid_operation_id"></a>

## `invalid_operation_id`

The operation ID must be a UUID.

작업 식별자가 UUID 형식이 아닙니다.

수정 응답의 statusUrl로 작업 상태를 조회해 주세요.

<a id="invalid_operation_payload"></a>

## `invalid_operation_payload`

The operation payload is invalid.

작업 본문이 해당 작업에 요구되는 구조나 조건과 맞지 않습니다.

선택한 OperationID의 요청 형식과 본문을 비교해 주세요. 필요한 필드와 값만 수정해 주세요.

<a id="invalid_operations_queue"></a>

## `invalid_operations_queue`

The operations queue is not supported.

요청한 큐 종류를 지원하지 않습니다.

queue 경로에는 keto 또는 worksmobile을 사용하세요.

<a id="invalid_or_expired_code"></a>

## `invalid_or_expired_code`

The supplied code is invalid or expired.

제출한 코드가 유효하지 않거나 만료되었습니다.

현재 로그인 요청에서 받은 최신 코드를 확인해 주세요. 만료된 코드이면, 공식 인증 절차에서 새 코드를 요청해 주세요.

<a id="invalid_performance_import"></a>

## `invalid_performance_import`

The performance import has an invalid JSON structure.

성능 비교 JSON 형식 또는 필드가 유효하지 않습니다.

운영 센터 사용법의 입력 필드와 JSON 구문을 확인해 주세요.

<a id="invalid_phone"></a>

## `invalid_phone`

The phone number is invalid.

전화번호 값이 해당 필드의 입력 조건에 맞지 않습니다.

국가 코드와 번호 형식을 확인해 주세요. API가 요구한 형식으로 전화번호를 제출해 주세요.

<a id="invalid_primary_tenant"></a>

## `invalid_primary_tenant`

The primary tenant is invalid.

대표 Tenant를 지정한 primaryTenantId가 UUID 형식이 아닙니다.

Tenant 조회 응답에서 대상의 UUID를 확인해 주세요. 이름이나 slug 대신 해당 UUID를 primaryTenantId에 입력해 주세요.

<a id="invalid_profile_field"></a>

## `invalid_profile_field`

The profile field has an invalid value.

프로필 필드의 값 형식이 올바르지 않습니다.

employeeNumber, name, phone의 입력 형식을 확인해 주세요.

<a id="invalid_qr_browser_flow_owner"></a>

## `invalid_qr_browser_flow_owner`

The QR login browser flow owner is invalid.

QR 로그인 요청이 현재 브라우저 흐름의 소유자와 연결되지 않습니다.

QR을 표시한 원래 브라우저에서 절차를 진행해 주세요. 창이나 세션이 바뀌었으면 로그인부터 다시 시작해 주세요.

<a id="invalid_qr_request"></a>

## `invalid_qr_request`

The QR login request is invalid.

QR 로그인 요청의 입력 또는 연결 정보가 유효하지 않습니다.

공식 로그인 화면에서 새 QR 요청을 생성해 주세요. 다른 로그인 시도의 요청 정보를 섞지 마세요.

<a id="invalid_queue_item"></a>

## `invalid_queue_item`

The queue item ID must be a UUID.

큐 항목 ID가 UUID 형식이 아닙니다.

큐 목록 API가 반환한 항목 ID로 다시 요청하세요.

<a id="invalid_request"></a>

## `invalid_request`

The request is malformed or contains invalid parameters.

요청에 잘못된 매개변수나 누락된 입력이 있습니다.

응답의 안전한 상세 정보와 API 입력 조건을 확인해 주세요. 지적된 입력을 수정해 주세요.

<a id="invalid_revision"></a>

## `invalid_revision`

The profile revision has an invalid format.

revision의 형식이 올바르지 않습니다.

조회 응답의 revision 문자열을 그대로 전달해 주세요.

<a id="invalid_scope"></a>

## `invalid_scope`

The requested scope is invalid or not permitted.

요청한 scope가 유효하지 않거나 현재 클라이언트에 허용되지 않습니다.

등록된 scope 목록과 실제 요청 값을 비교해 주세요. 추가 범위가 필요하면, 서비스 관리자에게 승인을 요청해 주세요.

<a id="invalid_session"></a>

## `invalid_session`

The session is missing, invalid, or expired.

요청에 필요한 세션이 없거나 유효하지 않습니다.

원래 서비스의 로그인 화면에서 다시 인증해 주세요. 세션 값을 직접 수정하지 마세요.

<a id="invalid_session_reference"></a>

## `invalid_session_reference`

The session reference is invalid.

요청에 포함된 세션 참조가 유효하지 않습니다.

현재 로그인에서 제공한 세션 참조인지 확인해 주세요. 오래된 참조이면, 다시 로그인해 주세요.

<a id="invalid_source_tenant"></a>

## `invalid_source_tenant`

The source tenant is invalid.

가져오기 원본으로 지정한 Tenant가 활성 비공개 Tenant 조건을 충족하지 않습니다.

원본 Tenant의 활성 상태와 공개 범위를 확인해 주세요. 조건에 맞는 원본을 선택한 뒤 가져오기 미리보기를 생성해 주세요.

<a id="invalid_tenant_selector"></a>

## `invalid_tenant_selector`

The tenant selector is invalid.

Tenant를 지정한 값의 형식이나 조합이 유효하지 않습니다.

API가 허용한 Tenant 선택 필드를 확인해 주세요. 식별자와 slug를 혼동하지 마세요.

<a id="invalid_user_id"></a>

## `invalid_user_id`

The user identifier is invalid.

사용자 식별자가 필요한 형식이나 조건에 맞지 않습니다.

사용자 조회 응답에서 식별자를 확인해 주세요. 이름이나 이메일 대신 API가 요구한 사용자 식별자를 사용해 주세요.

<a id="invalid_value"></a>

## `invalid_value`

The supplied value is invalid.

입력 필드의 값이 허용된 조건에 맞지 않습니다.

응답에 표시한 필드와 해당 값의 제약 조건을 확인해 주세요. 허용된 값으로 수정해 주세요.

<a id="last_membership_required"></a>

## `last_membership_required`

The user must retain one membership.

요청대로 소속을 제거하면 유지해야 할 마지막 소속이 없어집니다.

유지할 소속을 확인해 주세요. 계정 종료가 목적이면, 소속 제거 대신 승인된 계정 처리 절차를 요청해 주세요.

<a id="login_blocked_by_admin"></a>

## `login_blocked_by_admin`

Login is blocked by an administrator.

관리자가 해당 계정의 로그인을 차단한 상태입니다.

계정 관리자에게 차단 사유와 해제 절차를 문의해 주세요. 다른 인증 경로로 차단을 우회하지 마세요.

<a id="login_completion_conflict"></a>

## `login_completion_conflict`

The login completion conflicts with the current state.

로그인 완료 요청이 이미 저장된 진행 상태와 충돌합니다.

현재 로그인 결과를 먼저 확인해 주세요. 응답이 새 로그인을 안내하면, 기존 완료 요청을 반복하지 말고 새 절차를 진행해 주세요.

<a id="login_policy_denied"></a>

## `login_policy_denied`

The login policy denied the request.

현재 로그인 요청이 적용 중인 정책을 충족하지 않습니다.

응답에 제공된 사유와 로그인 조건을 확인해 주세요. 서비스 관리자에게 이용 자격을 문의해 주세요.

<a id="login_policy_unavailable"></a>

## `login_policy_unavailable`

The login policy is unavailable.

서버가 로그인 허용 여부를 판단할 정책을 읽지 못했습니다. 로그인 자격이 없다는 판정은 아닙니다.

정책 서비스 상태를 담당자에게 확인해 주세요. 정책을 읽을 수 있을 때 공식 로그인 절차를 진행해 주세요.

<a id="login_prepare_forbidden"></a>

## `login_prepare_forbidden`

The login preparation request is not allowed.

현재 요청의 출처나 자격이 로그인 준비 절차의 허용 조건에 맞지 않습니다.

공식 서비스 주소와 허용된 로그인 경로를 사용했는지 확인해 주세요. 연동 구현이면, 요청 출처와 인증 방식을 검토해 주세요.

<a id="login_smoke_route_mismatch"></a>

## `login_smoke_route_mismatch`

The login route does not match the expected flow.

로그인 점검용 계정이 지정된 직접 전화번호 인증 경로를 사용하지 않았습니다.

점검 절차에 정한 직접 전화번호 로그인 경로를 사용해 주세요. 일반 계정의 로그인 정책을 변경하지 마세요.

<a id="m2m_policy_invalid"></a>

## `m2m_policy_invalid`

The machine to machine policy is invalid.

애플리케이션 유형과 서버 간 통신 정책의 구성이 맞지 않습니다.

applicationProfile과 m2mPolicy의 허용 조합을 확인해 주세요. 서비스 관리자에게 용도에 맞는 구성 검토를 요청해 주세요.

<a id="membership_invariant_violation"></a>

## `membership_invariant_violation`

The membership invariant is not satisfied.

요청한 소속 변경이 유지해야 할 소속 규칙을 위반합니다.

현재 대표 소속과 추가 소속을 함께 확인해 주세요. 응답에 표시한 규칙을 만족하도록 변경 내용을 수정해 주세요.

<a id="membership_unavailable"></a>

## `membership_unavailable`

Current tenant membership information is unavailable.

현재 소속 정보를 조회하거나 조직 경로를 구성할 수 없습니다.

잠시 후 다시 요청해 주세요. 오류가 계속되면, request\_id와 함께 운영자에게 문의해 주세요.

<a id="method_not_allowed"></a>

## `method_not_allowed`

The requested method is not allowed.

해당 경로가 요청한 HTTP 메서드를 지원하지 않습니다.

API 문서에서 경로와 HTTP 메서드를 함께 확인해 주세요. 지원되는 메서드로 호출해 주세요.

<a id="mfa_required"></a>

## `mfa_required`

Additional multi-factor authentication is required.

현재 작업에 필요한 다중 인증을 완료하지 않았습니다.

로그인 화면에서 안내한 추가 인증 수단으로 인증해 주세요. 인증 후 원래 작업을 계속해 주세요.

<a id="mirror_not_ready"></a>

## `mirror_not_ready`

The identity mirror is not ready.

조회용 복제 데이터가 요청을 처리할 준비 상태에 도달하지 않았습니다.

복제 처리의 진행 상태를 담당자에게 확인해 주세요. 준비되지 않은 결과를 빈 목록이나 전체 통계로 사용하지 마세요.

<a id="name_required"></a>

## `name_required`

A name is required.

요청한 자원에 필요한 이름이 없습니다.

대상 자원을 구분할 이름을 입력해 주세요.

<a id="network_assurance_subject_mismatch"></a>

## `network_assurance_subject_mismatch`

The network assurance subject does not match.

네트워크 인증에 연결된 사용자와 로그인 요청의 사용자가 다릅니다.

네트워크 인증 계정과 현재 로그인 계정을 확인해 주세요. 동일한 사용자로 공식 인증 절차를 다시 시작해 주세요.

<a id="not_found"></a>

## `not_found`

The requested resource does not exist.

요청한 자원을 현재 조회 범위에서 찾지 못했습니다.

자원 식별자와 경로를 확인해 주세요. 삭제나 이동 여부는 권한이 있는 담당자에게 확인해 주세요.

<a id="not_supported"></a>

## `not_supported`

The requested operation is not supported.

서버가 해당 요청 기능을 지원하지 않습니다.

현재 API에서 지원하는 기능을 확인해 주세요. 필요한 기능이 없으면, 서비스 담당자에게 요청해 주세요.

<a id="oidc_linkage_unavailable"></a>

## `oidc_linkage_unavailable`

OIDC linkage data is unavailable.

외부 로그인과 사용자 계정의 연결 정보를 조회하지 못했습니다.

연결 정보 저장소 상태를 담당자에게 확인해 주세요. 이 오류만으로 새 사용자 연결을 생성하지 마세요.

<a id="oidc_login_request_load_failed"></a>

## `oidc_login_request_load_failed`

The service failed to load the OIDC login request.

서버가 OIDC 로그인 요청을 읽지 못했습니다.

현재 로그인 요청의 유효 상태와 인증 서비스 상태를 확인해 주세요. 응답이 안내하면, 공식 서비스에서 로그인을 다시 시작해 주세요.

<a id="oidc_subject_conflict"></a>

## `oidc_subject_conflict`

The OIDC subject conflicts with an existing identity.

외부 로그인 주체가 기존 사용자 연결과 충돌합니다.

어떤 계정에 외부 로그인이 연결되었는지 관리자에게 확인해 주세요. 기존 연결을 임의로 삭제하거나 다른 계정에 덮어쓰지 마세요.

<a id="operation_in_flight"></a>

## `operation_in_flight`

An equivalent operation is already in progress.

같은 작업이 이미 처리 중입니다.

기존 작업의 식별자로 진행 상태를 조회해 주세요. 새 요청이나 새 Idempotency-Key로 같은 작업을 중복 제출하지 마세요.

<a id="operation_indeterminate"></a>

## `operation_indeterminate`

The operation result is unknown.

서버가 작업의 성공 또는 실패를 확정하지 못했습니다.

기존 작업 상태와 대상 자원을 먼저 조회해 주세요. 결과가 확인되기 전에는 새 Idempotency-Key로 같은 변경을 제출하지 마세요. 담당자에게 기존 요청 식별자로 확인을 요청해 주세요.

<a id="operation_not_approved"></a>

## `operation_not_approved`

The operation lacks approval.

요청한 작업을 애플리케이션에 승인된 작업 목록에서 사용할 수 없습니다.

요청한 OperationID와 승인된 작업 목록을 비교해 주세요. 담당 관리자에게 해당 작업의 등록과 승인 상태를 확인해 주세요.

<a id="operation_not_found"></a>

## `operation_not_found`

The operation was not found.

해당 사용자의 HR 작업을 찾을 수 없습니다.

수정 응답의 operationId와 사용자 ID를 확인해 주세요.

<a id="operations_artifact_not_found"></a>

## `operations_artifact_not_found`

The diagnostic artifact is unavailable or expired.

결과가 없거나 만료 또는 제거되었습니다.

작업 종류와 인스턴스를 확인하고 필요하면 새 진단 작업을 실행해 주세요.

<a id="operations_artifact_not_ready"></a>

## `operations_artifact_not_ready`

The diagnostic artifact is not ready.

진단 결과가 아직 준비되지 않았습니다.

작업이 끝난 뒤 다시 다운로드해 주세요.

<a id="operations_job_capacity"></a>

## `operations_job_capacity`

The operations job registry is at capacity.

인스턴스의 작업 수 제한에 도달했습니다.

진행 중인 작업 상태를 확인하고 작업이 끝난 뒤 다시 시도해 주세요.

<a id="operations_job_not_cancellable"></a>

## `operations_job_not_cancellable`

The operations job can no longer be canceled.

작업이 끝났거나 이미 취소 요청을 처리 중입니다.

작업 목록을 새로 고쳐 최종 상태를 확인해 주세요.

<a id="operations_job_not_found"></a>

## `operations_job_not_found`

The operations job does not exist on this instance.

이 인스턴스에 해당 작업이 없습니다.

작업을 시작한 인스턴스인지, 재시작이나 보관 만료가 있었는지 확인해 주세요.

<a id="operations_queue_item_not_cancellable"></a>

## `operations_queue_item_not_cancellable`

The queue item is missing, processing, or already complete.

큐 항목이 없거나 이미 처리 중 또는 완료 상태입니다.

큐 목록을 새로 고친 뒤 대기 또는 실패 항목을 선택하세요. 중단은 이미 실행한 외부 작업을 되돌리지 않습니다.

<a id="operations_queue_item_not_retryable"></a>

## `operations_queue_item_not_retryable`

The queue item is missing, stale, or not eligible for retry.

항목이 없거나 오래된 권한 변경이어서 재시도할 수 없습니다.

큐 상태와 최신 권한 작업을 다시 확인해 주세요. 과거 변경을 강제로 복원하지 마세요.

<a id="operations_queue_unavailable"></a>

## `operations_queue_unavailable`

Operations queue state is unavailable.

큐 상태를 조회하거나 갱신하지 못했습니다.

DB 상태와 서버 로그를 확인하고 다시 조회해 주세요.

<a id="org_context_source_unavailable"></a>

## `org_context_source_unavailable`

The organization context source is unavailable.

조직 정보 응답에 필요한 원본 데이터를 사용할 수 없습니다.

담당자에게 조직 원장과 연결 서비스 상태를 확인해 주세요. 이 오류를 조직이 없다는 응답으로 처리하지 마세요.

<a id="password_or_email_mismatch"></a>

## `password_or_email_mismatch`

The supplied password and email do not match.

제출한 이메일과 비밀번호로 인증하지 못했습니다. 어느 값이 잘못되었는지는 이 응답으로 구분하지 않습니다.

이메일 입력과 키보드 상태를 확인해 주세요. 비밀번호를 모르면 공식 비밀번호 복구 절차를 이용해 주세요.

<a id="performance_history_unavailable"></a>

## `performance_history_unavailable`

Performance history storage is unavailable.

성능 이력 저장소를 사용할 수 없습니다.

DB 상태를 확인한 뒤 같은 입력으로 다시 시도해 주세요.

<a id="performance_import_too_large"></a>

## `performance_import_too_large`

The performance import exceeds the permitted body size.

성능 비교 입력이 1 MiB를 초과했습니다.

항목이나 표본 수를 줄여 1 MiB 이하의 JSON을 전달해 주세요.

<a id="phone_number_e164_required"></a>

## `phone_number_e164_required`

The phone number must use E.164 format.

전화번호가 국가 코드를 포함하는 E.164 형식이 아닙니다.

더하기 기호와 국가 코드를 포함한 전화번호를 입력해 주세요. 해당 번호의 국가별 표기 규칙을 확인해 주세요.

<a id="pkce_restart_required"></a>

## `pkce_restart_required`

The authorization flow must be restarted.

현재 인가 흐름의 코드 검증 연결을 계속 사용할 수 없습니다.

진행 중인 인가 요청을 재전송하지 마세요. 새 코드 검증값을 사용하는 공식 로그인 절차를 처음부터 시작해 주세요.

<a id="prerequisite_not_ready"></a>

## `prerequisite_not_ready`

A required prerequisite is not ready.

요청 전에 완료해야 하는 준비 단계가 아직 끝나지 않았습니다.

응답에 표시한 선행 단계의 상태를 확인해 주세요. 해당 단계가 완료된 뒤 다음 작업을 진행해 주세요.

<a id="primary_tenant_change_not_supported"></a>

## `primary_tenant_change_not_supported`

Changing the primary tenant is not supported.

현재 소속 변경 API는 대표 Tenant 변경을 지원하지 않습니다.

이 요청에서 대표 Tenant 변경을 제외해 주세요. 대표 소속 변경이 필요하면, 해당 작업을 지원하는 관리 절차를 이용해 주세요.

<a id="primary_tenant_required"></a>

## `primary_tenant_required`

A primary tenant is required.

요청한 작업에 필요한 대표 Tenant가 지정되지 않았습니다.

현재 사용자의 대표 소속을 확인해 주세요. 권한 범위 안에서 유효한 대표 Tenant를 지정해 주세요.

<a id="profile_fields_required"></a>

## `profile_fields_required`

At least one supported profile field is required.

수정할 프로필 필드가 없습니다.

employeeNumber, name, phone 중 하나 이상을 전달해 주세요.

<a id="protected_identity"></a>

## `protected_identity`

This operation cannot access a protected identity.

일반 사용자가 아닌 보호 계정입니다.

일반 사용자 계정만 HR API로 조회하거나 수정해 주세요.

<a id="protected_tenant_scope"></a>

## `protected_tenant_scope`

The requested tenant scope is protected.

대상 Tenant가 Directory 연동에 허용되지 않는 보호 범위에 포함됩니다.

대상 Tenant가 보호 범위에 속하는지 확인해 주세요. 보호 범위의 변경은 승인된 관리 절차로 요청해 주세요.

<a id="public_tenant_required"></a>

## `public_tenant_required`

A public tenant is required.

가져오기 작업에 필요한 공개 Tenant 로그인 범위가 저장되지 않았습니다.

애플리케이션의 공개 Tenant 로그인 범위를 먼저 검토해 주세요. 담당 관리자가 해당 범위를 저장한 뒤 가져오기 미리보기를 다시 생성해 주세요.

<a id="qr_login_not_allowed"></a>

## `qr_login_not_allowed`

QR login is not allowed for this flow.

현재 로그인 흐름에서 QR 인증을 허용하지 않습니다.

화면에서 허용한 인증 수단을 사용해 주세요. QR 인증이 필요하면, 서비스 관리자에게 적용 정책을 문의해 주세요.

<a id="query_busy"></a>

## `query_busy`

The query capacity is busy.

서버의 조회 처리 용량이 현재 요청을 받을 수 없는 상태입니다.

조회 요청 수를 줄여 주세요. 서버가 안내한 대기 간격 후 읽기 요청을 다시 진행해 주세요.

<a id="query_invalid"></a>

## `query_invalid`

The query is invalid.

조회 조건의 형식이나 값이 유효하지 않습니다.

검색 필터와 정렬 및 날짜 값을 API 계약과 비교해 주세요. 잘못된 조건을 수정해 주세요.

<a id="query_too_broad"></a>

## `query_too_broad`

The query is too broad.

조회 대상 범위가 서버의 처리 제한을 초과했습니다.

기간이나 Tenant 등 지원되는 조건으로 범위를 줄여 주세요. 나눈 결과를 합칠 때 중복과 누락을 확인해 주세요.

<a id="rate_limited"></a>

## `rate_limited`

Too many requests were received.

요청 빈도가 서버의 허용량을 초과했습니다.

Retry-After가 있으면, 해당 시간 동안 기다려 주세요. 반복 요청 간격을 늘려 주세요. 변경 요청은 기존 처리 상태도 먼저 확인해 주세요.

<a id="reason_required"></a>

## `reason_required`

A reason is required.

작업에 필요한 사유가 입력되지 않았습니다.

변경 목적을 설명하는 사유를 입력해 주세요. 사유에 비밀값이나 인증 코드를 넣지 마세요.

<a id="reauthentication_required"></a>

## `reauthentication_required`

The user must authenticate again before continuing.

현재 인증으로 작업을 계속할 수 없습니다. 이 코드만으로 만료와 명시적 폐기를 구분할 수 없습니다.

서비스가 제공한 재인증 절차를 완료해 주세요. 설치형 갱신 API가 이 코드로 거절하면 해당 자격증명의 사용을 중단하고 PKCE 로그인을 시작해 주세요.

<a id="refresh_in_flight"></a>

## `refresh_in_flight`

A session refresh is already in progress.

같은 인증의 세션 갱신을 다른 요청이 처리하고 있습니다.

공유 저장소를 다시 읽어 최신 자격증명을 확인해 주세요. 아직 완료되지 않았다면 Retry-After를 지키고 같은 논리 요청을 재시도해 주세요.

<a id="replaced_by_fixed_assignment"></a>

## `replaced_by_fixed_assignment`

The assignment was replaced by a fixed assignment.

기존 할당 요청이 고정 할당에 의해 대체되었습니다.

현재 적용된 고정 할당 내용을 확인해 주세요. 대체된 요청을 다시 제출하기 전에 담당자와 적용할 값을 결정해 주세요.

<a id="replay_response_expired"></a>

## `replay_response_expired`

The stored replay response expired.

기존 작업을 재전송할 때 반환할 저장 응답의 보관 기간이 지났습니다. 원래 작업이 실패했다는 뜻은 아닙니다.

기존 작업과 대상 자원의 상태를 먼저 조회해 주세요. 결과 확인 없이 새 Idempotency-Key로 같은 작업을 제출하지 마세요.

<a id="request_entity_too_large"></a>

## `request_entity_too_large`

The request body exceeds the permitted size.

요청 본문이 서버의 허용 크기를 초과했습니다.

본문의 항목 수와 첨부 크기를 줄여 주세요. 일괄 작업이면, API가 허용하는 크기로 나누어 제출해 주세요.

<a id="required"></a>

## `required`

The required value is missing.

필수 입력 값이 없습니다.

응답의 필드 경로를 확인해 주세요. 해당 필드에 API가 요구하는 값을 입력해 주세요.

<a id="required_consent_missing"></a>

## `required_consent_missing`

Required consent is missing.

현재 작업에 필요한 동의 항목이 빠져 있습니다.

동의 화면에서 필수 항목과 요청 범위를 검토해 주세요. 동의할 항목을 선택한 뒤 절차를 완료해 주세요.

<a id="revision_conflict"></a>

## `revision_conflict`

The user changed after the supplied revision.

조회 이후 사용자 정보가 변경되었습니다.

프로필을 다시 조회한 뒤 최신 revision으로 변경 내용을 확인해 요청해 주세요.

<a id="rp_allowed_tenants_required"></a>

## `rp_allowed_tenants_required`

Select at least one allowed tenant when tenant access restriction is enabled.

Tenant 접근 제한이 켜졌지만 허용할 Tenant가 없습니다.

허용할 Tenant를 한 개 이상 선택하거나 Tenant 접근 제한을 해제해 주세요.

<a id="rp_auto_login_url_invalid"></a>

## `rp_auto_login_url_invalid`

Check the automatic login URL; production URLs must use HTTPS except for localhost.

자동 로그인 URL이 Redirect URI 등록 규칙을 만족하지 않습니다.

metadata.auto\_login\_url을 확인해 주세요. 프로덕션의 localhost 외 주소는 HTTPS를 사용해야 합니다.

<a id="rp_backchannel_logout_uri_invalid"></a>

## `rp_backchannel_logout_uri_invalid`

Use an absolute HTTPS Back-Channel Logout URL without credentials, fragments, or a private or local address.

Back-Channel Logout URI가 서버에서 발송 가능한 HTTPS 주소 규칙을 만족하지 않습니다.

HTTPS 절대 주소를 사용하고 사용자 정보·fragment·localhost·사설 IP 주소를 제외해 주세요.

<a id="rp_headless_jwks_uri_required"></a>

## `rp_headless_jwks_uri_required`

Enter the public JWKS URL for Server-side + Headless; inline keys are not supported.

Headless 로그인에 필요한 공개 JWKS URI가 없습니다.

JWKS URI를 입력해 주세요. 인라인 키 대신 RP가 제공하는 JWKS URL을 사용해 주세요.

<a id="rp_installed_policy_invalid"></a>

## `rp_installed_policy_invalid`

Check the installed app mode and device limits; active devices must not exceed registered devices.

Installed 앱의 mode 또는 등록·활성 기기 수 한도가 올바르지 않습니다.

installedAppRefreshPolicy의 mode와 기기 한도를 확인해 주세요. 활성 기기 한도는 등록 기기 한도를 초과할 수 없습니다.

<a id="rp_installed_security_incompatible"></a>

## `rp_installed_security_incompatible`

Installed apps require public PKCE, device binding, authorization\_code and refresh\_token grants, and offline\_access; Headless and JWKS are not allowed.

Installed 보안 정책과 앱 유형·인증 방식·grant·scope 설정이 충돌합니다.

Server-side + Headless를 사용할 때 Installed 모드를 off로 설정해 주세요. Installed 앱은 public PKCE와 기기 바인딩, authorization\_code·refresh\_token grant, offline\_access scope가 필요합니다.

<a id="rp_policy_not_active"></a>

## `rp_policy_not_active`

The relying party policy is not active.

요청한 서비스의 이용 정책이 활성 상태가 아닙니다.

서비스 관리자에게 해당 애플리케이션의 정책 상태를 확인해 주세요. 승인된 정책이 활성화된 뒤 이용해 주세요.

<a id="rp_redirect_uri_https_required"></a>

## `rp_redirect_uri_https_required`

Use an HTTPS redirect URL in production; HTTP is allowed only for localhost.

프로덕션에서 localhost 외의 HTTP Redirect URI가 거절되었습니다.

reason의 필드에 표시된 Redirect URI 또는 로그아웃 후 Redirect URI를 HTTPS로 변경해 주세요.

<a id="rp_redirect_uri_invalid"></a>

## `rp_redirect_uri_invalid`

Enter an absolute redirect URL without userinfo or a fragment and with a valid port.

Redirect URI의 절대 주소, 포트 또는 userinfo/fragment 조건을 만족하지 않습니다.

reason의 배열 인덱스에 해당하는 URI를 확인해 주세요. 사용자명·비밀번호·fragment를 제외하고 유효한 절대 URL을 입력해 주세요. Installed 앱의 custom scheme은 해당 프로필 규칙을 확인해 주세요.

<a id="rp_redirect_uri_multiple_values"></a>

## `rp_redirect_uri_multiple_values`

Send each redirect URL as a separate array item; do not include line breaks within a URL.

Redirect URI 배열의 한 항목에 줄바꿈이 포함되어 있습니다.

각 Redirect URI를 별도 배열 항목으로 전달해 주세요. DevFront 입력에서는 쉼표 또는 줄바꿈으로 URL을 구분해 주세요.

<a id="rp_redirect_uris_required"></a>

## `rp_redirect_uris_required`

Add at least one redirect URL for this interactive application.

Interactive 앱 생성 또는 수정 요청에 Redirect URI가 없습니다.

인증 응답을 받을 Redirect URI를 한 개 이상 등록해 주세요.

<a id="rp_whitelist_denied"></a>

## `rp_whitelist_denied`

The relying party is not on the allowlist.

요청한 서비스가 허용 목록에 포함되지 않았습니다.

서비스 식별자와 등록 상태를 확인해 주세요. 사용 승인이 필요하면, 담당자에게 허용 목록 등록 검토를 요청해 주세요.

<a id="scan_incomplete"></a>

## `scan_incomplete`

The requested scan is incomplete.

검사 대상이 안전한 조회 한도 등을 넘어 전체 검사를 끝내지 못했습니다.

부분 결과를 전체 정상 판정으로 사용하지 마세요. 지원되는 범위 제한이나 별도 검사 방법을 담당자에게 확인해 주세요.

<a id="scope_tenant_not_found"></a>

## `scope_tenant_not_found`

The scope tenant does not exist.

자격 증명 범위로 지정한 Tenant를 찾지 못했습니다.

범위의 Tenant 식별자와 삭제 여부를 확인해 주세요. 실제 존재하는 허용 대상 Tenant를 지정해 주세요.

<a id="scope_tenant_required"></a>

## `scope_tenant_required`

A tenant is required for this scope.

선택한 범위 종류에 필요한 Tenant 식별자가 없습니다.

Tenant 범위를 사용할 때 scope.tenantId를 지정해 주세요. 그 Tenant에 대한 권한을 확인해 주세요.

<a id="secondary_phone_must_differ"></a>

## `secondary_phone_must_differ`

The secondary phone number must differ from the primary phone number.

보조 전화번호가 기본 전화번호와 같습니다.

기본 번호와 다른 보조 번호를 입력해 주세요. 보조 번호가 필요 없으면, API가 허용하는 빈 값 처리 방식을 사용해 주세요.

<a id="service_unavailable"></a>

## `service_unavailable`

The service is temporarily unavailable.

현재 서버가 요청한 기능을 제공할 수 없습니다.

서비스 상태와 Retry-After 안내를 확인해 주세요. 변경 요청이면, 기존 작업 결과를 조회한 뒤 재시도 여부를 결정해 주세요.

<a id="session_expired"></a>

## `session_expired`

The session expired.

서버가 세션의 유효 시간 만료를 확인했습니다. 설치형 앱에서는 짧은 작업 세션만 만료되어 복구할 수 있는 경우가 있습니다.

next\_action이 refresh\_session이고 유효한 복구 자격증명을 보유했다면 세션 갱신 API를 호출해 주세요. 복구 자격증명이 없거나 갱신이 최종 거절되면 다시 로그인해 주세요.

<a id="session_refresh_absolute_expired"></a>

## `session_refresh_absolute_expired`

The session refresh credential reached its maximum lifetime.

설치형 복구 자격증명의 절대 기한이 지났습니다. HTTP 401의 최상위 code로 반환하며 갱신할 수 없습니다.

next\_action=restart\_login에 따라 PKCE 로그인을 새로 시작해 주세요. 같은 복구 자격증명을 다시 보내거나 기기 시각을 바꾸어 재시도하지 마세요.

<a id="session_refresh_idle_expired"></a>

## `session_refresh_idle_expired`

The session refresh credential expired after inactivity.

설치형 복구 자격증명의 미사용 기한이 지났습니다. HTTP 401의 최상위 code로 반환하며 갱신할 수 없습니다.

next\_action=restart\_login에 따라 PKCE 로그인을 새로 시작해 주세요. 새 로그인으로 받은 복구 자격증명과 기한을 함께 저장해 주세요.

<a id="session_subject_conflict"></a>

## `session_subject_conflict`

The session subject conflicts with the request.

현재 세션의 사용자와 요청에 연결된 사용자가 다릅니다.

사용할 계정과 요청의 사용자 식별자를 확인해 주세요. 올바른 계정으로 인증한 뒤 해당 계정의 요청을 생성해 주세요.

<a id="single_operation_required"></a>

## `single_operation_required`

Exactly one operation is required.

한 요청에 정확히 하나의 작업이 필요하지만 다른 수의 작업이 지정되었습니다.

요청을 작업별로 분리해 주세요. 각 요청에 허용된 작업 하나만 지정해 주세요.

<a id="single_top_level_tenant_required"></a>

## `single_top_level_tenant_required`

A single top level tenant is required.

사용자의 소속이 하나의 최상위 Tenant 아래에 있어야 하는 규칙을 충족하지 않습니다.

대표 소속과 추가 소속의 최상위 Tenant를 비교해 주세요. 담당 관리자와 허용된 소속 구성을 결정해 주세요.

<a id="single_value_required"></a>

## `single_value_required`

Exactly one value is required.

정확히 하나의 값이 필요한 필드에 다른 수의 값이 제공되었습니다.

오류가 표시된 필드에 값 하나만 지정해 주세요. 여러 작업이 필요하면, API 계약에 맞게 요청을 분리해 주세요.

<a id="slow_down"></a>

## `slow_down`

The client must slow down its polling or request rate.

상태 조회나 반복 요청의 간격이 서버 요구보다 짧습니다.

서버가 안내한 interval 또는 Retry-After에 따라 요청 간격을 늘려 주세요. 같은 요청을 동시에 여러 번 보내지 마세요.

<a id="sms_send_failed"></a>

## `sms_send_failed`

The service failed to send the SMS.

서버가 인증 SMS 발송을 완료하지 못했습니다.

메시지 수신 여부와 현재 인증 요청 상태를 먼저 확인해 주세요. 미수신 상태가 계속되면, 요청 식별자로 담당자에게 문의해 주세요.

<a id="sms_unavailable"></a>

## `sms_unavailable`

The SMS service is unavailable.

SMS 발송 서비스가 구성되지 않았거나 현재 사용할 수 없습니다.

담당자에게 SMS 서비스 구성과 공급자 상태 확인을 요청해 주세요. 로그인 화면에 다른 허용된 인증 수단이 있으면, 해당 절차를 이용해 주세요.

<a id="snapshot_expired"></a>

## `snapshot_expired`

The snapshot expired.

목록 조회의 기준이 되는 저장 시점 정보가 만료되었습니다.

기존 페이지 이동 정보를 제거해 주세요. 첫 페이지부터 새 조회를 시작해 주세요.

<a id="source_incomplete"></a>

## `source_incomplete`

The source does not contain a complete result.

원본에서 완전한 결과를 확보하지 못했습니다. 제공된 항목만으로 전체 상태를 판단할 수 없습니다.

누락 범위와 조회 제한을 확인해 주세요. 완전한 결과를 확보하기 전에는 전체 합계나 일괄 변경의 근거로 사용하지 마세요.

<a id="source_unavailable"></a>

## `source_unavailable`

The source is unavailable.

요청에 필요한 원본 데이터를 조회할 수 없습니다. 원본이 없다는 판정은 아닙니다.

원본 서비스의 상태를 담당자에게 확인해 주세요. 조회 실패를 빈 결과로 처리하거나 원본 삭제의 근거로 사용하지 마세요.

<a id="stack_snapshot_unavailable"></a>

## `stack_snapshot_unavailable`

The goroutine stack snapshot is unavailable.

goroutine 스택을 수집하지 못했습니다.

진단 허용 설정과 인스턴스 상태를 확인한 뒤 다시 시도해 주세요.

<a id="superseded_by_direct_assignment"></a>

## `superseded_by_direct_assignment`

The assignment was superseded by a direct assignment.

기존 할당 요청이 직접 지정한 값으로 대체되었습니다.

현재 직접 할당된 값을 확인해 주세요. 대체된 이전 요청을 자동으로 다시 적용하지 마세요.

<a id="temporarily_unavailable"></a>

## `temporarily_unavailable`

The requested service is temporarily unavailable.

요청한 기능을 일시적으로 사용할 수 없습니다.

서비스 상태와 대기 안내를 확인해 주세요. 변경 요청이면, 이미 처리된 결과가 있는지 먼저 확인해 주세요.

<a id="tenant_action_scope_invalid"></a>

## `tenant_action_scope_invalid`

The tenant action scope is invalid.

Tenant 작업의 적용 범위가 허용된 구성에 맞지 않습니다.

changes.scope와 해당 작업의 허용 범위를 비교해 주세요. 권한이 있는 대상 범위로 요청을 수정해 주세요.

<a id="tenant_affiliation_projection_mismatch"></a>

## `tenant_affiliation_projection_mismatch`

The tenant affiliation projection does not match the authoritative state.

소속 원장과 조회용 소속 데이터의 내용이 일치하지 않습니다.

관리자에게 소속 원장과 정합성 검사 결과의 비교를 요청해 주세요. 조회용 데이터에 맞추려고 원본 소속을 임의로 변경하지 마세요.

<a id="tenant_affiliation_projection_unavailable"></a>

## `tenant_affiliation_projection_unavailable`

The tenant affiliation projection is unavailable.

소속 조회용 데이터를 사용할 수 없어 원장과의 일치를 확인하지 못했습니다.

담당자에게 소속 데이터 동기화와 저장소 상태를 확인해 주세요. 사용자에게 소속이 없다고 처리하지 마세요.

<a id="tenant_business_registration_number_conflict"></a>

## `tenant_business_registration_number_conflict`

The business registration number conflicts with an existing tenant.

사업자등록번호가 기존 Tenant에 등록된 번호와 충돌합니다.

같은 사업자등록번호의 기존 Tenant를 검토해 주세요. 중복 생성 대신 승인된 중복 검토 절차를 진행해 주세요.

<a id="tenant_domain_conflict"></a>

## `tenant_domain_conflict`

The tenant domain conflicts with an existing domain.

지정한 도메인이 기존 Tenant의 도메인 등록과 충돌합니다.

현재 도메인 등록 대상을 조회해 주세요. 같은 조직의 기존 Tenant인지 확인한 뒤 관리자가 등록 대상을 결정해 주세요.

<a id="tenant_graph_unavailable"></a>

## `tenant_graph_unavailable`

The tenant graph is unavailable.

Tenant의 부모 관계와 범위를 판단할 계층 정보를 사용할 수 없습니다.

담당자에게 Tenant 계층 원장과 조회 상태를 확인해 주세요. 계층이 확인되기 전에는 범위를 넓혀 요청하지 마세요.

<a id="tenant_not_allowed"></a>

## `tenant_not_allowed`

The tenant is not allowed for this operation.

현재 요청에서 해당 Tenant를 사용할 수 없습니다.

대상 Tenant와 현재 사용자 또는 자격 증명의 허용 범위를 비교해 주세요. 필요한 접근은 관리자에게 승인을 요청해 주세요.

<a id="tenant_not_found"></a>

## `tenant_not_found`

The requested tenant does not exist.

요청한 Tenant를 현재 조회에서 찾지 못했습니다.

Tenant 식별자와 조회 범위를 확인해 주세요. 삭제나 이동 여부는 관리 화면에서 확인해 주세요.

<a id="tenant_policy_managed_centrally"></a>

## `tenant_policy_managed_centrally`

The tenant policy is managed by a central authority.

애플리케이션에서 변경하려는 Tenant 접근 제한은 중앙 로그인 정책에서 관리합니다.

로그인 보안 화면에서 현재 Tenant 접근 제한을 확인해 주세요. 정책 변경 권한이 있는 담당자에게 변경을 요청해 주세요.

<a id="tenant_public_organization_code_conflict"></a>

## `tenant_public_organization_code_conflict`

The public organization code conflicts with an existing tenant.

공공기관 코드가 기존 Tenant의 등록과 충돌합니다.

해당 코드가 등록된 Tenant를 확인해 주세요. 기관 식별자를 임의로 바꾸지 말고 관리자에게 중복 검토를 요청해 주세요.

<a id="tenant_scope_unavailable"></a>

## `tenant_scope_unavailable`

The tenant scope is unavailable.

요청에 적용할 Tenant 범위를 확인할 수 없습니다.

사용 중인 자격 증명과 대상 Tenant를 확인해 주세요. 범위 조회 장애이면, 담당자에게 복구 확인을 요청해 주세요.

<a id="tenant_selector_required"></a>

## `tenant_selector_required`

A tenant selector is required.

요청에서 대상 Tenant를 선택할 값이 빠져 있습니다.

API가 요구하는 Tenant 식별자 또는 선택 필드를 입력해 주세요. 현재 권한 범위의 대상을 선택해 주세요.

<a id="timezone_invalid"></a>

## `timezone_invalid`

The time zone value is invalid.

시간대 값이 서버에서 지원하는 형식이나 값이 아닙니다.

해당 API가 허용하는 시간대 이름을 확인해 주세요. 표시용 시간대와 전송할 날짜·시간 형식을 구분해 주세요.

<a id="totp_enrollment_required"></a>

## `totp_enrollment_required`

TOTP enrollment is required before continuing.

다음 작업에 필요한 TOTP 인증 수단이 등록되지 않았습니다.

공식 보안 설정 화면에서 시간 기반 일회용 코드인 TOTP를 등록해 주세요. 등록 절차의 확인을 마친 뒤 원래 작업으로 돌아가 주세요.

<a id="trial_claim_history_conflict"></a>

## `trial_claim_history_conflict`

The stored trial claim history conflicts with the requested operation.

저장된 RP trial 만료 이력이 요청된 값과 충돌합니다.

기존 trial 원장과 고정 만료값을 확인해 주세요. 충돌을 해결하기 전에는 새 trial을 지급하거나 값을 덮어쓰지 마세요.

<a id="trial_claim_managed"></a>

## `trial_claim_managed`

The trial claim is managed by the trial entitlement ledger.

RP trial 만료 claim은 trial 원장에서 관리되므로 일반 metadata API로 변경할 수 없습니다.

trial 원장의 정책과 지급 상태를 확인해 주세요. 일반 metadata 수정 요청에서 해당 claim을 제외해 주세요.

<a id="trial_entitlement_unavailable"></a>

## `trial_entitlement_unavailable`

The trial entitlement ledger is unavailable.

RP trial 지급 원장을 사용할 수 없습니다.

서비스 관리자에게 trial 원장과 데이터베이스 상태를 확인해 주세요. 원장 장애를 새 trial 지급이나 기본 만료값으로 대체하지 마세요.

<a id="unauthorized"></a>

## `unauthorized`

Authentication is required for this request.

요청에 유효한 인증 정보가 없습니다.

해당 API가 요구하는 인증 방식을 확인해 주세요. 사용자 작업이면, 공식 로그인 화면에서 인증해 주세요.

<a id="unexpected_browser_credentials"></a>

## `unexpected_browser_credentials`

Browser credentials are not allowed for this flow.

현재 인증 흐름은 브라우저 세션 등 대화형 인증 정보의 동시 전달을 허용하지 않습니다.

해당 API가 요구하는 인증 정보만 전송해 주세요. 연동 구현에서 자동으로 붙이는 브라우저 쿠키나 다른 인증 헤더가 있는지 확인해 주세요.

<a id="unprocessable_entity"></a>

## `unprocessable_entity`

The well formed request fails processing.

요청 형식은 해석했지만 입력 내용이 작업 처리 조건을 충족하지 않습니다.

응답의 필드 오류와 업무 조건을 확인해 주세요. 해당 조건에 맞게 입력 내용을 수정해 주세요.

<a id="unsupported"></a>

## `unsupported`

The supplied value is not supported.

입력 필드에 서버가 지원하지 않는 값이 지정되었습니다.

응답의 필드 경로와 허용 값 목록을 확인해 주세요. 지원되는 값을 지정해 주세요.

<a id="unsupported_media_type"></a>

## `unsupported_media_type`

The request media type is not supported.

요청의 Content-Type을 해당 API가 지원하지 않습니다.

API가 요구하는 Content-Type과 본문 형식을 함께 확인해 주세요. 지원되는 형식으로 전송해 주세요.

<a id="unsupported_operation"></a>

## `unsupported_operation`

The requested operation is not supported.

현재 API나 자격 증명 체계가 요청한 작업을 지원하지 않습니다.

지원하는 OperationID와 경로 목록을 확인해 주세요. 다른 작업을 같은 식별자로 대신 호출하지 마세요.

<a id="upstream_outcome_unknown"></a>

## `upstream_outcome_unknown`

The upstream operation result is unknown.

연결된 인증 서비스가 로그인 완료 또는 동의 승인·거절을 처리했는지 서버가 확정하지 못했습니다.

현재 로그인 상태를 먼저 확인해 주세요. 같은 완료 요청은 같은 키나 새 Idempotency-Key로도 재전송하지 마세요. 로그인이 필요하면, 공식 서비스에서 새 로그인 절차를 시작해 주세요.

<a id="upstream_rate_limited"></a>

## `upstream_rate_limited`

An upstream service rate limited the request.

연결된 서비스가 요청 빈도를 제한했습니다.

Retry-After가 있으면, 안내한 시간 동안 기다려 주세요. 변경 요청이면, 기존 처리 결과를 확인한 뒤 API가 허용하는 재시도 방식을 사용해 주세요.

<a id="upstream_response_invalid"></a>

## `upstream_response_invalid`

The upstream service returned an invalid response.

연결된 서비스의 응답을 예상한 형식이나 조건으로 처리할 수 없습니다.

담당자에게 요청 식별자와 응답 오류를 전달해 주세요. 변경 요청이면, 연결된 서비스의 처리 결과를 먼저 확인해 주세요.

<a id="upstream_unavailable"></a>

## `upstream_unavailable`

The upstream service is unavailable.

연결된 서비스가 요청 처리에 필요한 기능을 제공하지 못했습니다.

담당자에게 연결 서비스의 상태를 확인해 주세요. 변경 요청이면, 실제 처리 결과를 조회한 뒤 후속 요청을 결정해 주세요.

<a id="upstream_unreachable"></a>

## `upstream_unreachable`

The upstream service is unreachable.

서버가 연결된 서비스에 도달하지 못했습니다.

담당자에게 서비스 주소와 네트워크 연결 상태를 확인해 주세요. 변경 요청이면, 기존 작업의 처리 상태부터 확인해 주세요.

<a id="user_already_exists"></a>

## `user_already_exists`

The user already exists.

등록하려는 사용자가 기존 사용자와 중복됩니다.

기존 사용자 목록에서 같은 식별자를 확인해 주세요. 새 계정 생성 대신 기존 계정의 이용 또는 복구 절차를 검토해 주세요.

<a id="user_not_found"></a>

## `user_not_found`

The requested user does not exist.

요청한 사용자를 현재 조회 범위에서 찾지 못했습니다.

사용자 식별자와 조회 범위를 확인해 주세요. 사용자 삭제 여부는 권한이 있는 관리자에게 확인해 주세요.

<a id="validation_failed"></a>

## `validation_failed`

One or more request fields failed validation.

하나 이상의 요청 필드가 입력 검사를 통과하지 못했습니다.

응답의 필드별 오류 목록을 확인해 주세요. 지적된 필드의 값과 형식을 수정해 주세요.

<a id="worksmobile_visibility_conflict"></a>

## `worksmobile_visibility_conflict`

The Worksmobile visibility conflicts with the requested operation.

Worksmobile에서 비공개인 상위 조직 아래에 공개 조직을 지정하려고 했습니다.

config.worksmobileVisible 값과 상위 조직의 노출 규칙을 확인해 주세요. 담당 관리자에게 허용된 노출 구성의 검토를 요청해 주세요.