カスタムドメイン
Workato APIエンドポイントを独自のドメイン経由でルーティングし、独自のサブドメインでWorkato APIエンドポイントを公開します。 たとえば、エンドポイントを変更して会社のサブドメインを反映させます。
元のAPI URL: https://apim.workato.com/boltco/sales-api/get-invoice
カスタムドメインURL: https://api.boltcompany.com/sales-api/get-invoice
Workatoのカスタムドメイン名では大文字と小文字は区別されません。
機能の提供状況
API platformのカスタムドメインは、中国データセンターではサポートされていません。 これは現地の規制要件を反映したものであり、当社のマルチテナントおよびVirtual Private Workato（VPW）サービスに適用されます。
カスタムドメインの設定
VIRTUAL PRIVATE WORKATO (VPW)のお客様
この機能を使用するには、お使いのVirtual Private Workato（VPW）インスタンスに固有の設定手順が必要です。 VPWをご利用のお客様は、インスタンスの設定詳細について、VPWのプライベートドキュメントを参照してください。
登録済みのドメイン名とサブドメイン名を準備します。 ドメイン名の詳細については、ICANNドキュメントを参照してください。 例: blog.boltcompany.com。
プラットフォーム > API Platform > 設定 > カスタムドメインに移動し、ドメインを追加をクリックします。
カスタムドメインを登録
サブドメイン名を入力し、ドメインを追加をクリックします。
ドメインを登録
ドメインホストでCNAMEレコードを設定して、カスタムドメインを検証します。 以下の手順では、例としてCloudflareを使用します。
レコードを追加をクリックし、タイプとしてCNAMEを選択して、サブドメイン名を指定します。例: ドメインboltcompany.comの場合はapi。
CloudflareでCNAMEレコードを作成
一意のターゲット値をカスタムドメイン設定からコピーして貼り付けます。 この値をCNAMEレコードに使用します。 例: abcde123456.apim-custom.workato.com。
一意のCNAMEターゲットをカスタムドメイン設定からコピー
保存をクリックします。
新しいCNAMEレコードがグローバルドメインネームシステム全体に反映されるまで、ドメインホストによっては最大1時間かかる場合があります。 WorkatoはカスタムドメインのDNSを検証した後、TLS証明書の生成を開始します。 証明書が発行されて使用可能になるまで、最大1時間かかる場合があります。 カスタムドメインページを更新してステータスを確認します。
元のエンドポイント名を使用できますか
- 元のAPIエンドポイントは、カスタムドメインと並行して引き続き機能します。
- カスタムドメインへのリクエストは、特定のIPアドレスのセットにルーティングされます。
TLSの証明書
WorkatoのAPI platformを使用する場合、デフォルトドメインはworkato.comです。 カスタムドメインがサポートされています。 カスタムドメインを追加すると、新しい証明書が自動的に作成されます。 Workatoは、追加したカスタムドメインでHTTPSを有効にするためにAPI証明書を管理します。
証明書の更新
カスタムドメイン証明書は、設定された有効期限の1か月前に自動的に更新されます。 WorkatoはLet’s Encryptで更新プロセスを管理します。 カスタムドメインの新しい証明書リクエストには、DNSレコードまたはLet’s Encryptによって指定されたその他の検証方法によるドメイン所有権の検証が含まれます。 Workatoは、Let's Encryptによる発行後に新しい証明書を自動的にデプロイします。 このシームレスな移行により、ユーザー側での手動対応や中断なしに、カスタムドメインはHTTPSで引き続き動作します。
認証局承認（CAA）レコード
サイトの証明書発行を許可する認証局（CA）を制限している場合、カスタムドメインの証明書を発行しようとすると、カスタムドメインワークフローは失敗します。 これを解決するには、Let's Encryptのドメイン名letsencrypt.orgのCAAレコードを追加します。 詳細を確認する。
カスタムドメイン設定の削除
API platformを別のカスタムドメインに再設定する場合、現在のカスタムドメイン設定を削除する必要があることがあります。
画面右上の削除をクリックします。カスタムドメインページ
カスタムドメイン削除ウィザードの注意事項を読みます。 チェックボックスをオンにし、ドメインを削除を選択します。
カスタムドメインを削除
APIのデフォルトはapim.workato.comになります。 まだ行っていない場合は、このAPIコレクションの既存ユーザーに新しいドメインについて通知します。
カスタムドメインAPIM IPアドレス
Workatoは、APIレシピにカスタムドメインを使用する際、クライアントトラフィックをデータセンター固有のIPアドレスにルーティングします。 詳細については、カスタムAPIMドメインとIPアドレスドキュメントを参照してください。
Last updated: