API 403 Forbidden 오류: 권한과 사용 정책 점검 순서

403 Forbidden은 서버가 요청을 이해했지만 접근을 허용하지 않았다는 뜻입니다. 토큰 권한, 대상 리소스 소유권, API 활성화와 서비스 정책을 확인해야 하며, 무조건 IP나 계정을 바꾸는 것은 해결책이 아닙니다.

재시도 전에 확인할 항목

  1. 응답 본문의 공식 오류 코드와 요청 식별자를 기록합니다.
  2. 인증 토큰의 만료와 필요한 범위를 확인합니다.
  3. 프로젝트의 API 활성화 상태와 대상 문서·사이트 권한을 확인합니다.
  4. 사용 중인 API가 해당 콘텐츠와 계정에 허용되는지 확인합니다.
  5. 조직 정책·요청 제한·지원 문의 절차를 확인합니다.

로그에 비밀값을 남기지 않는 예제

다음은 네트워크를 호출하지 않고, 애플리케이션에서 상태 코드를 분류하는 Python 3 예제입니다.

def classify_status(status):
    if status == 403:
        return "권한과 사용 정책 확인: 자동 반복 중단"
    if status == 429:
        return "제공자 안내에 따라 대기"
    if 500 <= status < 600:
        return "멱등성과 재시도 제한 확인"
    return "응답 본문과 작업 결과 확인"

assert "자동 반복 중단" in classify_status(403)
print(classify_status(403))

401·403·429는 서비스마다 세부 의미와 오류 본문이 다를 수 있습니다. 숫자만 보고 모든 실패를 같은 재시도로 처리하지 마세요. 로그에는 인증 헤더, 키 파일 본문, 고객 정보가 들어가지 않아야 합니다.

Indexing API의 403이라면

권한 문제 외에 API의 적용 대상도 확인해야 합니다. 일반 블로그 글을 Google Indexing API로 대량 제출하는 설계부터 재검토해야 할 수 있습니다. 해당 API의 적격 콘텐츠와 계정 소유권 조건을 공식 문서에서 확인하세요.

공식 참고: Indexing API 오류. 관련 글: Indexing API 사용 범위, API 키 저장, API·운영 가이드.

작성: 로그 · 2026-10-17 수정: 우회 중심 설명을 권한·정책 진단 절차로 교체했습니다.

댓글

댓글 쓰기

이 블로그의 인기 게시물

API 키 저장 방법: 해싱과 암호화의 차이, Fernet 예제

외부 서비스 호출에 다시 사용할 API 키는 해시만 저장하면 안 됩니다. 원문이 필요한 키는 비밀 관리 서비스나 복호화 가능한 저장 방식을 사용하고, 들어온 키가 맞는지만 확인하는 서버 발급 키는 검증용 저장 방식을 설계해야 합니다. 먼저 API 키의 용도를 나누세요 용도 원문 복구 검토할 방식 외부 API에 인증 헤더로 전송 필요 비밀 관리 서비스 또는 키를 분리한 인증된 암호화 내 서비스가 발급한 키의 일치 여부 확인 보통 불필요 충분한 무작위성의 키 발급과 해시·HMAC 검증 설계 개발용 임시 키 필요 환경변수 등으로 코드에서 분리하고 저장소에 포함하지 않기 해싱은 암호화의 다른 이름이 아닙니다. 해시값을 외부 서비스의 원래 API 키 자리에 넣으면 인증되지 않습니다. 비밀번호용 반복 해시 설정을 API 키 전체에 일률적으로 적용하는 것도 적절하지 않습니다. 비밀번호와 고엔트로피 무작위 토큰은 위협 모델이 다릅니다. Fernet으로 암호화와 복호화 흐름 확인하기 다음은 Python 3 환경과 cryptography 패키지에서 흐름을 이해하기 위한 로컬 예제입니다. 설치는 python -m pip install cryptography 로 진행합니다. 예제는 실제 서비스 키를 사용하지 않으며, 운영용 키 보관 시스템 전체를 구현한 코드는 아닙니다. from cryptography.fernet import Fernet encryption_key = Fernet.generate_key() cipher = Fernet(encryption_key) sample_key = b"demo-key-not-for-production" ciphertext = cipher.encrypt(sample_key) restored = cipher.decrypt(ciphertext) assert restored == sample_key print("roundtrip ok") 출력은 roundtrip ok 입니다. 암호문은 생성할 때마다...
자세한 내용 보기

파이썬 Google Sheets API 연동: 서비스 계정 권한과 읽기·쓰기

파이썬에서 Google 스프레드시트를 읽고 쓰려면 사용할 인증 주체에 시트 접근 권한을 주고, 필요한 API와 범위를 설정해야 합니다. 서비스 계정을 생성했다는 사실만으로 개인 시트를 읽을 수 있는 것은 아닙니다. 서비스 계정과 사용자 OAuth 선택 서버에서 정해진 시트만 처리하는 작업에는 서비스 계정을 검토할 수 있습니다. 사용자가 직접 자신의 자료 접근을 승인하는 앱에는 사용자 OAuth가 적합할 수 있습니다. 조직 정책에 따라 키 파일 발급이나 외부 공유가 제한될 수 있으므로 관리자 정책도 확인하세요. 연결 전에 확인할 항목 Google Cloud 프로젝트에서 사용하려는 Sheets API를 활성화합니다. 사용하는 기능에 따라 Drive API도 필요할 수 있습니다. 서비스 계정 인증 정보를 안전한 위치에 준비합니다. 대상 시트를 서비스 계정 이메일과 공유하고 필요한 최소 권한만 부여합니다. 시트 URL의 문서 ID와 워크시트 이름을 확인합니다. 정해진 범위만 읽고 쓰는 예제 python -m pip install gspread google-auth 로 설치합니다. 다음 코드는 실제 API를 사용하며, 지정된 워크시트의 A1:B2를 덮어씁니다. 반드시 복사한 테스트 시트에서 실행하세요. 아래 외부 연동 예제는 이 사이트의 로컬 코드 검증 대상에 포함하지 않았습니다. import os import gspread key_file = os.environ["GOOGLE_SERVICE_ACCOUNT_FILE"] sheet_id = os.environ["GOOGLE_SHEET_ID"] client = gspread.service_account(filename=key_file) worksheet = client.open_by_key(sheet_id).worksheet("테스트") worksheet.update( range_name="A1:B2", values=[[...
자세한 내용 보기

Pandas 결측치 처리: isna, fillna, dropna 선택 기준

Pandas 결측치는 isna() 로 위치와 개수를 확인한 뒤, 열의 의미에 따라 삭제·유지·대체를 결정합니다. 결측치 비율만으로 행이나 열을 지우는 보편적인 정답은 없습니다. 삭제하기 전에 확인할 질문 누락이 시스템 장애인지, 해당되지 않는 값인지, 아직 입력되지 않은 값인지 구분하세요. 특히 매출 0과 매출 미확인은 서로 다른 정보입니다. 식별번호가 없을 때와 선택 항목이 비어 있을 때도 같은 규칙으로 처리하면 안 됩니다. 작은 표로 처리 결과 확인하기 Python 3와 Pandas가 필요합니다. python -m pip install pandas 로 설치한 뒤 실행하세요. 아래는 필수 식별자가 없는 행은 제외하고, 지역 미입력은 별도 범주로 표시하며, 금액 누락은 그대로 보존하는 예제입니다. import pandas as pd df = pd.DataFrame({ "order_id": ["001", "002", None, "004"], "region": ["서울", None, "부산", "서울"], "amount": [10000, None, 5000, 0], }) print(df.isna().sum().to_dict()) clean = df.dropna(subset=["order_id"]).copy() clean["region"] = clean["region"].fillna("미입력") assert len(clean) == 3 assert clean["amount"].isna().sum() == 1 assert (clean["amount"] == 0).sum() == 1 print(clean.to_string(index=False)) 처음 집계는 각 열의 결...
자세한 내용 보기