이 페이지에는 AlloyDB Auth Proxy 사용 시 문제가 발생할 경우 도움이 되는 문제 해결 팁이 나열되어 있습니다.
AlloyDB 인증 프록시를 사용하여 AlloyDB 인스턴스에 연결하는 데 문제가 있는 경우 다음과 같이 문제의 원인을 찾을 수 있습니다.
AlloyDB 인증 프록시 출력을 주의 깊게 확인하고 오류를 찾습니다. 오류 메시지는 문제의 원인과 해결 방법을 파악하는 데 필요한 정보를 제공하는 경우가 많습니다.
403 Forbidden 오류가 발생하고 서비스 계정으로 AlloyDB 인증 프록시를 인증하는 경우 서비스 계정에 올바른 권한이 있는지 확인하세요.
이러한 권한을 제공하는 사전 정의된 AlloyDB 역할은 Cloud AlloyDB 클라이언트 (roles/alloydb.client) 및 Cloud AlloyDB 관리자(roles/alloydb.admin)입니다. 또한 서비스 사용량 소비자(roles/serviceusage.serviceUsageConsumer) 역할을 추가해야 합니다.
AlloyDB API를 사용 설정해야 합니다.
사용 설정되어 있지 않으면 AlloyDB 인증 프록시 로그에 Error 403: Access Not
Configured와 같은 출력이 표시됩니다.
UNIX 소켓을 사용하여 연결하는 경우 AlloyDB 인증 프록시를 시작할 때 지정한 디렉터리를 나열하여 소켓이 생성되었는지 확인합니다.
아웃바운드 방화벽 정책이 있는 경우 대상 AlloyDB 인스턴스에서 포트 5433에 연결할 수 있는지 확인합니다.
할당량 문제: 할당량 초과와 관련된 오류가 표시되면 할당량 문제의 원인을 식별합니다. 예를 들어 애플리케이션이 커넥터를 오용하고 있고 불필요하게 새 연결을 만들고 있을 수 있습니다. 또는 지원팀에 연락하여 AlloyDB API 할당량 증가를 요청합니다.
reauth related error이 포함된 오류 메시지와 함께 400 Bad Request 응답이 표시되면 gcloud 애플리케이션 기본 사용자 인증 정보를 새로고침합니다.
[[["이해하기 쉬움","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-05(UTC)"],[[["\u003cp\u003eThis page provides troubleshooting advice for users experiencing issues with the AlloyDB Auth Proxy.\u003c/p\u003e\n"],["\u003cp\u003eReview the AlloyDB Auth Proxy output for specific error messages, which often indicate the problem's source and solution.\u003c/p\u003e\n"],["\u003cp\u003eVerify that service accounts have the necessary permissions, including Cloud AlloyDB Client or Admin roles, and the Service Usage Consumer role, to avoid \u003ccode\u003e403 Forbidden\u003c/code\u003e errors.\u003c/p\u003e\n"],["\u003cp\u003eEnsure the AlloyDB Admin API is enabled to prevent \u003ccode\u003eError 403: Access Not Configured\u003c/code\u003e messages in the logs.\u003c/p\u003e\n"],["\u003cp\u003eIf facing quota-related errors or \u003ccode\u003e400 Bad Request\u003c/code\u003e responses with reauth issues, then addressing the source of the quota issue or refreshing the gcloud application default credentials, respectively, may fix the problem.\u003c/p\u003e\n"]]],[],null,["# Troubleshoot AlloyDB Auth Proxy connections\n\nThis page lists troubleshooting tips in case you run into problems using the\nAlloyDB Auth Proxy.\n\nIf you are having trouble connecting to your AlloyDB instance using\nthe AlloyDB Auth Proxy, here are a few things to try to find what's causing the\nproblem.\n\n- Check the AlloyDB Auth Proxy output carefully and look for errors. Often, the\n error messages provide the information you need determine the source of the\n problem and how to solve it.\n\n- If you are getting a `403 Forbidden` error, and you are using a service\n account to authenticate the AlloyDB Auth Proxy, make sure the service account has the\n correct permissions.\n\n The predefined AlloyDB roles that provide these permissions are Cloud\n AlloyDB Client (`roles/alloydb.client`) and Cloud AlloyDB Admin\n (`roles/alloydb.admin`). In addition, you must add the Service Usage Consumer\n (`roles/serviceusage.serviceUsageConsumer`) role.\n- Make sure to enable the AlloyDB API.\n\n If it is not enabled, you see output like `Error 403: Access Not\n Configured` in your AlloyDB Auth Proxy logs.\n- If you are connecting using UNIX sockets, confirm that the sockets were\n created by listing the directory you provided when you started the AlloyDB Auth Proxy.\n\n- If you have an outbound firewall policy, make sure it allows connections\n to port 5433 on the target AlloyDB instance.\n\n | **Note:** The Auth Proxy client uses 5433 to connect to the Auth Proxy server. Port 5432 is the default port for the PostgreSQL protocol over a direct TCP connection.\n- Quota issues: If you see errors related to quotas being exceeded, either\n identify the source of the quota problem (for example, an\n application is misusing the connector and unnecessarily creating new\n connections) or contact support to request an increase to the AlloyDB API\n quota.\n\n- If you get a `400 Bad Request` response with an error message containing\n `reauth related error`, refresh your gcloud application default\n credentials:\n\n gcloud auth application-default login\n\n For more information, see [How Application Default Credentials works](/docs/authentication/application-default-credentials)."]]
