---
title: KurocoFrontで独自APIドメインを利用する手順
description: KurocoFrontへ独自APIドメインを適用する方法を紹介します。APIドメインを適用するには、そのドメインに対してDNSレコードを設定する権限が必要になります。
---

KurocoFrontへ独自APIドメインを適用する方法を紹介します。    
独自APIドメインを適用するには、そのドメインに対してDNSレコードを設定する権限が必要になります。

## APIドメイン利用手順

### 1. APIドメインを入力
[環境設定] -> [独自ドメイン/TLS証明書]をクリックし、「独自APIドメイン」のテキストフィールドに利用するドメインを入力します。

:::tip
最後尾にスラッシュやディレクトリなどは必要ありません。
:::

![Image from Gyazo](https://t.gyazo.com/teams/diverta/328db4c19a7b8cbe76a549a01597ad8d.png)

入力後、「追加する」ボタンをクリックします。

![Image from Gyazo](https://t.gyazo.com/teams/diverta/6ebfe4afe6e24be9a3e754de158712ae.png)

:::danger 要注意
独自APIドメインは一度追加すると変更ができません。間違って入力してしまった場合は、サポート宛にご連絡をお願いいたします。    
[フォームより問い合わせをする](https://kuroco.zendesk.com/)
:::

暫くすると、以下のように設定するべきDNSレコードが表示されます。  

![Image from Gyazo](https://t.gyazo.com/teams/diverta/559e84909a8e528acb16a971f3cd600f.png)

### 2. DNSレコードの設定
次にDNSレコードの設定をします。表示されている内容に従い、CNAME/Aレコードを設定してください。

![Image from Gyazo](https://t.gyazo.com/teams/diverta/7e335a3fb53ff463986c9ee8d070d8fc.png)

:::tip
DNSレコードの設定は取得したドメイン会社により異なります。詳細な設定方法は取得したドメイン会社にてご確認ください。  
-[お名前.com Navi ネームサーバー/DNSについて](https://www.onamae.com/guide/p/70)  
-[Google Domainsヘルプ ドメイン ネームサーバーの管理](https://support.google.com/domains/answer/3290309?hl=ja)  
:::

DNSレコードをセットすると、ドメイン所有権の確認にOKが表示され、しばらく時間がたつとTLS証明書が発行されます。

![Image from Gyazo](https://t.gyazo.com/teams/diverta/dcda60ce31fe04ed64c9145d356185d6.png)

:::tip
DNSレコードの反映およびステータスの更新には時間がかかることがあります。OKが表示されない場合は、時間を置いてから「リロードする」ボタンを押して確認してください。
:::

:::info
独自ドメイン/TLS証明書 の ドメイン所有権の確認 は、dns.google.com を利用してDNSレコードの確認を行っています。  
下記の画面から DNSレコードのキャッシュのクリアが出来るので、お急ぎの場合はこちらをお試しいただくと早く更新されることがあります。  
https://developers.google.com/speed/public-dns/cache?hl=ja  

Doman Name:`_acme-challenge.api.CUSTOM_API_DOMAIN`  
RR Type:`CNAME`
:::

### 3. APIドメインの変更
TLS証明書が発行されたら、APIドメインを先ほど設定した独自ドメインに変更します。  

:::caution
デフォルトのAPIドメイン(`kuroco.app`)は使用できなくなります。既に公開済みのサイトでAPIドメインを変更する場合は、リクエスト先の変更とタイミングを合わせて実施ください。
:::

[環境設定] -> [アカウント設定]をクリックし、アカウント設定画面を表示します。

![Image from Gyazo](https://t.gyazo.com/teams/diverta/170770ebee636e370c9ad40e4df3482f.png)

「APIドメイン」に設定した独自APIドメインが表示されるので、チェックを入れ「更新する」をクリックします。

![Image from Gyazo](https://t.gyazo.com/teams/diverta/98511da63d88255b7ac1e800dfb103ee.png)

これで独自APIドメインが利用できるようになりました。

### 4. APIドメインの記述箇所の変更
フロントエンドなどで、デフォルトのAPIドメインの記述がある場合は、独自APIドメインに変更します。  
APIドメインの記述箇所は実装によりますが、以下に記述されている場合が多いので参考にしてください。  

- GitHubシークレット
- .envファイル
- vueファイル

## 関連ドキュメント
独自ドメインの設定方法は下記をご確認ください。
- [KurocoFrontで独自ドメインを利用する手順](/ja/docs/tutorials/using-a-custom-domain-name-on-kurocofront/)
