여러 사이트 API 인증 설정: 자격 증명 참조 분리

5월 05, 2026

여러 사이트의 인증 설정은 사이트 주소와 비밀값 참조를 분리하고, 실행 전에 허용된 호스트인지 검증합니다.

어떤 상황에서 적용하나요?

JSON 키 파일을 여러 도메인에 재사용한다고 모든 사이트 권한이 생기지는 않습니다. 다음 예제는 토큰 없이 설정 구조만 검사합니다. 실제 인증 권한은 각 서비스에서 별도로 부여해야 합니다.

검증 범위: 아래 코드는 외부 서비스에 요청하지 않는 로컬 예제입니다. 실제 서비스 연결은 별도로 검증해야 합니다.

최소 예제로 동작 확인하기

from urllib.parse import urlparse

allowed = {"www.example.com", "docs.example.com"}
configs = [{"url": "https://docs.example.com/", "credential_ref": "DOCS_TOKEN"}]
for config in configs:
    parsed = urlparse(config["url"])
    if parsed.scheme != "https" or parsed.hostname not in allowed:
        raise ValueError("허용되지 않은 사이트")
    if not config.get("credential_ref"):
        raise ValueError("인증 정보 참조가 없습니다")
assert len(configs) == 1
print("설정 검증 완료")

결과는 어떻게 확인하나요?

설정 검증 완료가 출력됩니다. 이는 인증 성공이 아니라 로컬 설정의 필수 조건을 통과했다는 뜻입니다. 참조 이름은 실행 시 환경변수나 비밀 저장소에서 실제 자격 증명을 찾는 데 사용합니다.

실제 업무에 적용할 때 확인할 점

일반 블로그 글은 Google Indexing API의 일반적인 적용 대상이 아닙니다. 서비스 계정을 Search Console에 추가하더라도 해당 API의 콘텐츠 제한을 없애지 못합니다. 권한과 API 적용 범위를 분리해 판단하고 필요한 사이트에만 최소 권한을 부여하세요.

공식 자료와 다음 단계

관련 공식 문서에서 사용하는 버전의 기능과 제한을 확인하세요.

학습 경로: API·운영 가이드 · 인증 오류 확인

작성: 로그 · 2026-10-17 수정: 확인되지 않은 경험담과 성능 보장 표현을 제거하고 예제·적용 조건·공식 근거를 보완했습니다.

실전 파이썬 노트