로그인 시 커스텀 도메인 표시

이 문서에서는 사용자가 로그인할 때 도메인을 볼 수 있도록 Identity Platform 인증 핸들러를 맞춤설정하는 방법을 보여줍니다.

기본 인증 핸들러 이해

프로젝트에 Identity Platform을 사용 설정하면 Firebase 호스팅에서 제공하는 고유한 하위 도메인이 자동으로 생성됩니다. 도메인은 https://[PROJECT-ID].firebaseapp.com 형식을 취합니다. 기본적으로 Identity Platform은 이 도메인을 사용하여 모든 OAuth, OIDC, SAML 로그인 리디렉션을 사용합니다.

기본 도메인을 사용하면 여러 가지 이점이 있습니다.

  • 동일한 제휴 제공업체를 통해 여러 도메인 사용

  • 여러 서비스와 도메인에서 하나의 콜백 URL 공유

  • 앱당 하나의 콜백 URL만 지원하는 제공업체와 협력

기본 핸들러의 단점은 사용자가 로그인할 때 https://[PROJECT-ID].firebaseapp.com URL이 잠시 표시된다는 점입니다.

인증 핸들러 맞춤설정

기본 핸들러를 맞춤 핸들러로 재정의하려면 다음 단계를 따르세요.

  1. Firebase Console에서 프로젝트를 커스텀 도메인에 연결합니다.

  2. Google Cloud 콘솔에서 Identity Platform > ID 공급업체 페이지로 이동합니다.
    ID 공급업체로 이동

  3. ID 공급업체를 선택합니다.

  4. 프로젝트 설정 측면 창에서 도메인 추가를 클릭하고 맞춤 도메인을 추가합니다.

  5. 저장을 클릭합니다.

  6. 앱 구성에서 콜백 URL을 기본 도메인 대신 커스텀 도메인으로 업데이트합니다. 예를 들어 https://myproject.firebaseapp.com/__/auth/handlerhttps://auth.mycustomdomain.com/__/auth/handler로 변경합니다.

클라이언트 SDK 구성 업데이트

Google Cloud 콘솔에서 클라이언트 SDK의 초기화 코드를 복사할 수 있습니다. 인증 핸들러를 맞춤설정하는 경우 authDomain 필드를 커스텀 도메인으로 업데이트해야 합니다.

웹 버전 9

import { initializeApp } from "firebase/app";

const firebaseConfig = {
  apiKey: "...",
  // By default, authDomain is '[YOUR_APP].firebaseapp.com'.
  // You may replace it with a custom domain.
  authDomain: '[YOUR_CUSTOM_DOMAIN]'
};
const firebaseApp = initializeApp(firebaseConfig);

웹 버전 8

firebase.initializeApp({
  apiKey: '...',
  // By default, authDomain is '[YOUR_APP].firebaseapp.com'.
  // You may replace it with a custom domain.
  authDomain: '[YOUR_CUSTOM_DOMAIN]'
});

Android 및 iOS

인증 핸들러를 맞춤설정하려면 다음 코드를 사용합니다.

자바

FirebaseAuth.getInstance().setCustomAuthDomain("[YOUR_CUSTOM_DOMAIN]");

Kotlin+KTX

Firebase.auth.setCustomAuthDomain("[YOUR_CUSTOM_DOMAIN]")

Swift

let auth = Auth.auth()
auth.customAuthDomain = "[YOUR_CUSTOM_DOMAIN]"

Objective-C

FIRAuth *auth = [FIRAuth auth];
auth.customAuthDomain("[YOUR_CUSTOM_DOMAIN]");