프로젝트에서 커스텀 도메인을 사용하는 경우 이메일 인증, 주소 변경, 비밀번호 복구 과정과 같은 인증 이벤트를 위해 전송되는 이메일에 커스텀 도메인을 사용하는 것이 좋습니다. 이메일의 From 필드와 작업 링크에서 커스텀 도메인을 사용하도록 프로젝트를 구성할 수 있습니다.
인증 이메일에 커스텀 도메인을 구성하면 사용자에게 웹 주소 및 사용자 관리 이메일이 동일한 도메인으로 표시됩니다.
그러면 도메인 소유권을 확인하기 위해 도메인 등록기관에 추가할 DNS 레코드 표가 표시됩니다.
도메인 확인
Firebase 콘솔에서 제공된 TXT 및 CNAME DNS 레코드를 추가하거나 업데이트합니다.
작업 절차는 등록기관에 따라 다릅니다.
특정 도메인에 v=spf1... TXT 레코드는 하나만 있을 수 있습니다. 여러 이메일 주소를 지정해야 하는 경우 레코드 하나로 결합합니다.
도메인을 확인하는 데 최대 24시간이 걸릴 수 있습니다. 확인이 완료되면 Firebase 콘솔의 템플릿 페이지에 초록색으로 '확인 완료' 메시지가 표시됩니다. 그런 다음 커스텀 도메인 적용 버튼을 클릭하여 변경사항을 적용할 수 있습니다.
멀티 테넌트 프로젝트
Firebase Authentication with Identity Platform으로 업그레이드하고 멀티테넌시를 사용 설정한 경우 테넌트에서 커스텀 도메인, 이메일 템플릿, 커스텀 SMTP 설정을 상속하도록 허용하려면 테넌트 메타데이터를 업데이트해야 합니다.
그렇지 않으면 커스텀 도메인이 성공적으로 확인되고 적용된 경우에도 사용자가 기본 도메인에서 이메일을 받게 됩니다.
인증 이메일 메시지에 포함된 URL을 검사하여 멀티테넌시가 사용 설정되었는지 확인할 수 있습니다. URL에 tenant 매개변수가 포함되어 있으면 프로젝트의 테넌트 메타데이터를 업데이트해야 합니다.
[null,null,["최종 업데이트: 2025-08-04(UTC)"],[],[],null,["If you use a custom domain in your project, consider also using your custom\ndomain in the emails sent for authentication events, such as email verification,\naddress change, and password recovery flows. You can configure your project to\nuse your custom domain in the emails' `From` field and action links.\n\nBy configuring custom domains for authentication emails, users will see the same\ndomain for your web address and the user management emails.\n\nThere are broadly two steps to setting this up:\n\n- Add the domain to your email templates in the Firebase console.\n- Verify your domain by adding DNS records in your domain registar.\n\nAdding the domain to your email templates\n\n1. In the Firebase console, open the\n [Templates page](//console.firebase.google.com/project/_/authentication/emails) of\n the Authentication section.\n\n2. For each email template, do the following:\n\n 1. Click the edit icon (edit).\n 2. Click **customize domain**.\n 3. Enter the domain you want to use.\n\nYou'll then see a table of DNS records to add to your domain registrar to verify\nthat you own the domain.\n\nVerify the domain\n\nAdd or update the TXT and CNAME DNS records given in the Firebase console.\nThe procedure for doing so depends on the registrar.\n\nYou can have only one `v=spf1...` TXT record for a particular domain. If you\nneed to specify multiple email addresses, combine them into one record.\n| **Note:** If you've used GoDaddy as your registrar, customers have reported that they're unable to add a record that only includes the apex domain, and instead need to use `@` in place of the apex domain.\n\nIt can take up to 24 hours for the domain to be verified. When it is, the\nTemplates page in the Firebase console will show a green \"Verification\ncomplete\" message. Then, you can click the **Apply Custom Domain** button to put\nyour changes into effect.\n\nMulti-tenant projects\n\nIf you have upgraded to Firebase Authentication with Identity Platform and enabled [multi-tenancy](https://cloud.google.com/identity-platform/docs/multi-tenancy-authentication),\nyou need to update [the tenant metadata](https://cloud.google.com/identity-platform/docs/reference/rest/v2/projects.tenants#inheritance)\nto allow the tenant to inherit custom domains, email templates, and custom SMTP settings.\nOtherwise, users still receive emails from the default domain even if the custom domain is\nsuccessfully verified and applied.\n\nYou can check if multi-tenancy is enabled by examining the URL included in Auth\nemail messages. If the URL includes a `tenant` parameter, you need to update\nyour project's tenant metadata.\n\nTo do so, run the following command: \n\n curl -X PATCH -d \"{'inheritance':{'emailSendingConfig': true}}\" \\\n -H \"X-Goog-User-Project: \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e\" \\\n -H \"Authorization: Bearer $(gcloud auth print-access-token)\" \\\n -H 'Content-Type:application/json' \\\n https://identitytoolkit.googleapis.com/v2/projects/\u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-n\"\u003ePROJECT_ID\u003c/span\u003e\u003c/var\u003e/tenants/\u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-n\"\u003eTENANT_ID\u003c/span\u003e\u003c/var\u003e?updateMask=inheritance.emailSendingConfig"]]
