カスタムドメイン

Workato API エンドポイントを、ご使用の独自ドメイン経由でルーティングし、独自のサブドメイン下に公開できます。たとえば、会社のサブドメインを反映するようにエンドポイントを変更できます。

元の API URL: https://apim.workato.com/boltco/sales-api/get-invoice

カスタムドメインの URL: https://api.boltcompany.com/sales-api/get-invoice

TIP

Workato のカスタムドメインでは大文字と小文字が区別されません。

カスタムドメインの設定

1

登録済みのドメインとサブドメイン名を用意します。ドメイン名について、詳しくは ICANN のドキュメント (opens new window)を参照してください。例として、blog.boltcompany.com などが挙げられます。

2

[Tools] > [API Platform] > [Settings] > [Custom domain] に移動し、 [Register custom domain] をクリックします。

カスタムドメインの登録

3

サブドメイン名を入力し、 [Add domain] をクリックします。

ドメインの登録

ドメインホストで CNAME レコードを設定し、カスタムドメインの確認を行います。以下の手順では、例として Cloudflare を使用します。

4

[Add record] をクリックします。タイプとして CNAME を選択します。 サブドメイン名を入力します。この例では、ドメイン boltcompany.com のサブドメイン api を作成します。

Cloudflare で CNAME レコードを作成

5

ターゲットを指定します。apim-custom.workato.com をコピーして貼り付けます。

別のデータセンターを利用している場合

Workato では、ユーザーが自分のレシピや API コレクションを、コンプライアンスのために別のデータセンターでホストすることができます。米国のデータセンターを利用していない場合は、CNAME レコードで別のターゲット URL を使用してください。

EU のデータセンター: apim-custom.eu.workato.com 日本のデータセンター: apim-custom.jp.workato.com シンガポールのデータセンター: apim-custom.sg.workato.com

6

[Save] をクリックします。

ドメインホストによっては、新しい CNAME レコードがグローバルなドメイン名システムに反映されるまで、最長1時間かかることがあります。カスタムドメインの DNS の確認が済んだら、Workato は TLS 証明書の生成を開始します。証明書が発行され、使用の準備が整うまで、最長で1時間かかることがあります。 [Custom domains] ページを更新し、ステータスを確認してください。

エンドポイントの元の名前の使用について

• 元の API エンドポイントは、カスタムドメインと並んで引き続き機能します。
• カスタムドメインへのリクエストは、特定の IP アドレスのセットにルーティングされます。

TLS の証明書

Workato の API プラットフォームを使用する際、デフォルトのドメインは workato.com となります。カスタムドメインを追加する場合は、Workato が API の証明書を管理し、カスタムドメインに対して HTTPS を有効にします。新しい証明書は、カスタムドメインを追加したときに自動的に作成されます。これらの証明書は、有効期限が切れる1か月前に自動的に更新されます。Workato では、Let's Encrypt (opens new window) を利用して、API の証明書を作成および管理しています。

CAA レコード

サイトの証明書を発行できる CA を制限している場合、カスタムドメインの証明書を発行しようとすると、カスタムドメインのワークフローでエラーが発生します。これを解決するには、Let's Encrypt のドメイン名 letsencrypt.org の CAA レコードを追加します。詳細はこちら (opens new window)をご覧ください。

カスタムドメイン設定の削除

API プラットフォームを別のカスタムドメインに設定し直したい場合は、現在のカスタムドメイン設定を削除しなければならないことがあります。

1

画面右上の [Remove] をクリックします。
カスタムドメインページ

2

[Remove custom domain] ウィザードに表示される注意をお読みください。チェックボックスにチェックを入れて、 [Remove Domain] を選択します。
カスタムドメインの削除

API はデフォルトで apim.workato.com になります。次に、この API コレクションの既存のユーザーに変更について通知します (まだ通知していない場合)。