/.well-known/* URI 레퍼런스

IANA 등록 well-known URI 검색 카탈로그 — security.txt·openid-configuration·apple-app-site-association·acme-challenge 외 30+개, RFC 레퍼런스·사용 사례 포함.

검색카테고리

표시 중: 39 / 39

/.well-known/security.txt

보안RFC 9116

보안 공개 연락처 정보·정책의 표준 위치. 필수: Contact·Expires.

/.well-known/openid-configuration

아이덴티티OIDC Discovery

OpenID Connect 프로바이더 구성 문서 — 인증·토큰·userinfo 엔드포인트·지원 스코프·JWKS URI.

/.well-known/oauth-authorization-server

아이덴티티RFC 8414

OAuth 2.0 인증 서버 메타데이터. OIDC 디스커버리와 비슷하지만 일반 OAuth 2.0 배포용.

/.well-known/oauth-protected-resource

아이덴티티RFC 9728

OAuth 2.0 보호 리소스 메타데이터 — 클라이언트에 이 API 보호하는 인증 서버 알림.

/.well-known/jwks.json

아이덴티티JWK Set

JSON Web Key Set — 이 서버 발행 JWT 검증에 쓰는 공개 키.

/.well-known/webfinger

아이덴티티RFC 7033

계정 URI(acct:user@example.com)로 도메인에 속한 사람·개체의 정보를 찾는 디스커버리.

/.well-known/host-meta

아이덴티티RFC 6415

사이트 전체 메타데이터 문서, WebFinger 전신. XRD 포맷.

/.well-known/nostr.json

아이덴티티NIP-05

NIP-05 검증 — 이름(user@example.com)과 Nostr 공개 키를 연결.

/.well-known/change-password

웹W3C draft

사용자 비밀번호 변경 원할 때 브라우저가 리다이렉트하는 표준 URL(W3C 초안).

/.well-known/apple-app-site-association

모바일Apple

Apple 유니버설 링크와 Handoff 연결 정보. applinks·webcredentials 키를 담은 JSON.

/.well-known/assetlinks.json

모바일Google

Android Digital Asset Links — App Links용 앱-웹사이트 소유권 검증.

/.well-known/acme-challenge/<token>

보안RFC 8555

ACME HTTP-01 챌린지 토큰 — Let's Encrypt 등 CA가 도메인 컨트롤 검증용.

/.well-known/mta-sts.txt

메일RFC 8461

수신 이메일용 Mail Transfer Agent Strict Transport Security 정책.

/.well-known/dnt-policy.txt

보안EFF

EFF Do Not Track 정책 선언 — 폐기된 DNT 브라우저 헤더 이전.

/.well-known/traffic-advice

웹Chrome

프라이빗 프리페치 프록시(Chrome)에 보낼 최대 처리량 알림.

/.well-known/ai.txt

웹Industry

업계 제안 AI 학습 옵트아웃 선호 선언 컨벤션.

/.well-known/llms.txt

웹Industry

LLM에 큐레이션된 머신 친화적 사이트 개요 제공 제안 컨벤션.

/.well-known/privacy-policy

웹Convention

캐노니컬 개인정보 처리방침 URL 컨벤션 — 표준화 안 됐으나 보편적.

/.well-known/dat

기타DAT

Dat P2P hyperdrive 디스커버리.

/.well-known/did.json

아이덴티티DID Web

DID Web 방식 — did:web:example.com을 DID 문서로 해석.

/.well-known/matrix/server

기타Matrix

Matrix 서버-서버 페더레이션 디스커버리.

/.well-known/matrix/client

기타Matrix

Matrix 클라이언트-서버 홈서버 디스커버리.

/.well-known/ashrae135

기타BACnet

BACnet 빌딩 자동화 디바이스 디스커버리.

/.well-known/caldav

기타RFC 6764

CalDAV 캘린더 서버 디스커버리(RFC 6764).

/.well-known/carddav

기타RFC 6764

CardDAV 연락처 서버 디스커버리(RFC 6764).

/.well-known/est/cacerts

보안RFC 7030

Enrollment over Secure Transport — CA 인증서 검색(RFC 7030).

/.well-known/gnap-as-rs

아이덴티티GNAP

Grant Negotiation and Authorization Protocol 메타데이터.

/.well-known/included-in-set/<algorithm>

보안RFC 9335

투명성 로그용 집합 포함 증명(RFC 9335).

/.well-known/jmap

메일RFC 8620

JSON Meta Application Protocol 메일 디스커버리(RFC 8620).

/.well-known/openpgpkey/hu/<localpart>

메일WKD

OpenPGP Web Key Directory — 이메일 주소로 PGP 키 디스커버.

/.well-known/payment-manifest.json

웹W3C

W3C Payment Manifest — 지원 결제 방법 선언.

/.well-known/posh/<hostname>.json

보안RFC 7711

PKIX over Secure HTTP — TLS 인증서 게시(RFC 7711).

/.well-known/reload-config

기타RFC 6940

REsource LOcation And Discovery 구성(RFC 6940).

/.well-known/sip

기타RFC 7095

SIP 서비스 디스커버리(RFC 7095).

/.well-known/sips

기타RFC 7095

SIPS 서비스 디스커버리(RFC 7095).

/.well-known/stun

기타RFC 7064

STUN 서버 디스커버리(RFC 7064).

/.well-known/turn

기타RFC 7065

TURN 서버 디스커버리(RFC 7065).

/.well-known/timezone

기타RFC 7808

iCalendar 타임존 서비스 디스커버리(RFC 7808).

/.well-known/oauth-token-introspection

아이덴티티RFC 7662

OAuth 2.0 토큰 내부 검토 엔드포인트(RFC 7662).

IANA Well-Known URI 레지스트리 + 사실상 업계 컨벤션 출처.

사용법

카테고리로 필터(보안은 security.txt/ACME, 아이덴티티는 OIDC/OAuth, 모바일은 앱 딥링크).
경로·RFC 번호·설명 텍스트로 검색. 클릭 한 번에 경로 복사.
RFC·스펙으로 이동해 정확한 콘텐츠 요구사항 확인 — 대부분 특정 JSON 스키마·텍스트 포맷 있음.

자세한 설명

펼치기

RFC 8615는 /.well-known/를 예측 가능한 위치 필요한 사이트 메타데이터의 표준 경로로 정의 — 디스커버리 엔드포인트·보안 연락처·모바일 앱 딥링크 연결·ACME 검증 토큰·아이덴티티 프로바이더 구성. 이 레퍼런스는 IANA 등록 URI(+ 일부 사실상 업계 표준)를 목적별로 그룹화 나열: 보안·아이덴티티·모바일·웹·메일·기타. 각 항목은 정의 RFC·스펙으로 링크 → 정확한 요구사항 읽기 가능. 새 도메인 설정, OIDC 디스커버리 플로 디버깅, Apple 유니버설 링크 어느 경로인지 기억할 때 유용.

자주 묻는 질문

/.well-known/ URI를 IANA에 등록해야 하나?

새 공개 프로토콜 정의 시 그렇다. IANA Well-Known URI 레지스트리(https://www.iana.org/assignments/well-known-uris)가 충돌 방지 위해 추적. 자체 앱 내부 비공개 용도엔 어떤 서브패스든 사용 가능 — 단 URI가 나중에 다른 사람 프로토콜로 등록되면 충돌 위험.

/.well-known/ 경로는 HTTPS 전용으로 제공해야 하나?

대부분 그렇다. security.txt는 RFC 9116에 따라 HTTPS 필요. apple-app-site-association은 HTTPS 필요(예전엔 리다이렉트 없음도 필요, 완화됨). OIDC 디스커버리·OAuth 메타데이터·대부분 아이덴티티 엔드포인트 HTTPS 필요. 예외 몇몇은 보편적 TLS 이전의 레거시 텍스트 파일.

왜 이런 파일을 고정된 경로에 두나, 알려주면 되지 않나?

고정된 경로는 묻지 않고도 확인할 수 있기 때문이다. 스캐너나 브라우저나 다른 서버가 URL 하나를 찾아보고 문서가 있는지 없는지만 확인하면 된다. 협상도, 사전 링크도 필요 없다. 서로 존재를 모르는 사이트들 사이에서 자동 발견이 가능한 이유가 이것이다. 대가는 그 경로가 모두가 공유하는 이름 공간이라는 점이고, 그래서 등록 제도가 있다.

실제로 이 경로를 망가뜨리는 것은?

대개 리디렉션과 잘못된 콘텐츠 타입이다. 클라이언트는 리디렉션되는 well-known URL을 거부하는 경우가 많고, 이 문서들 중 여럿은 HTML이 아니라 JSON으로 제공돼야 한다. 그래서 프레임워크가 사이트의 404 페이지를 200 상태로 돌려주면 성공처럼 보이면서 검증에 실패한다. 점으로 시작하는 디렉터리는 정적 호스팅과 빌드 도구가 조용히 제외하곤 하는 종류이기도 하다. 소스 트리가 아니라 배포된 URL을 확인하라.

/.well-known/* URI 레퍼런스

사용법

자세한 설명

자주 묻는 질문

관련 도구

상대 URL 해석기 (RFC 3986)

포트 번호 참조

PWA Manifest 빌더

URI 템플릿 확장기 (RFC 6570)

TXT 레코드 분할기 (255바이트 청크)

HTTP 헤더 참조