企業の URL を変更する

企業がアクセスされる URL を変更したい場合は、企業スラッグを変更できます。

この機能を使用できるユーザーについて

Enterprise owners can change the URL for the enterprise.

この記事で

enterprise スラッグの変更について

企業を作成するとき、「スラッグ」と呼ばれる企業用の文字列を選びます。これは、企業のURLで使用される文字列です。 たとえば、octo-enterprise をスラッグとして選択すると、GitHub.com 上のエンタープライズの URL は https://github.com/enterprises/octo-enterprise になります。

会社がクレジットカードまたはPayPalでGitHub Enterprise Cloudの支払いをしている場合、企業の設定でスラッグを変更できます。 URLスラッグを変更すると、GitHub は古い URL からのリダイレクトを設定しません。 以前の enterprise スラッグはすぐに他の顧客が使用できるようになります。

メモ

請求書を使用して GitHub Enterprise Cloud を支払う場合、または貴社で Enterprise Managed Users を利用している場合、企業スラッグを変更するには、GitHub の営業チーム に連絡する必要があります。 GHE.com でホストされている Enterprise、Enterprise スラッグの変更は現在サポートされていません。

enterprise スラッグを変更するときの考慮事項

企業スラッグを変更する前に、企業の構成、自動化、または古い企業スラッグに依存している可能性のあるプロセスの一部を考慮してください。 中断を最小限に抑えるため、スラッグを変更する直前または直後にこれらの点に対処してください。

スラッグを変更することで影響を受ける可能性のあるシステムの部分には、以下が含まれますが、これらに限定されません。

SAML シングル サインオン (SSO)

企業レベルで SAML シングル サインオン (SSO) を有効にしている場合は、新しい企業スラッグを使用するように、ID プロバイダー (IdP) の設定を再構成する必要があります。 スラッグを変更しても、既存の IdP セッションは取り消されませんが、IdP 設定を更新するまで、メンバーはSSOを使用して企業内のリソースにアクセスできません。 組織レベルで SAML または SCIM を有効にしている場合、スラッグを変更しても SSO には影響しません。 詳しくは、「Enterprise 向けの SAML シングルサインオンを設定する」をご覧ください。

スラッグを変更する前に、SSOが機能しない場合でもご利用の企業にアクセスできるようにするため、ご利用の企業の復旧コードをダウンロードすることをお勧めします。 詳しくは、「エンタープライズ アカウントのシングル サインオンの回復コードをダウンロードする」をご覧ください。

API エンドポイント

enterprise 管理用の多くの GitHub API エンドポイントは、enterprise スラッグをパラメーターとして受け取ります。 自動化でこれらのエンドポイントを使用する場合は、新しいスラッグを使用するように API 呼び出しを更新する必要があります。 古いスラグを使用する API 呼び出しはすぐに機能を停止します。 多くの場合、スラッグの代替として使用できるエンタープライズ ID は、スラッグの変更の影響を受けません。

OpenID Connect とGitHub Actions ワークフロー

GitHub Actions ワークフローで OpenID Connect (OIDC) を使用しており、エンタープライズスラッグを含む一意の URL からのトークンのみを受け入れるようにクラウドプロバイダーを構成している場合は、クラウドプロバイダーの設定を更新してください。 ワークフローが失敗するのを防ぐために、最も信頼性の高いオプションは、スラッグを変更する直前に、古いスラッグと新しいスラッグの両方からトークンを受け入れるようにプロバイダーを構成することです。 詳しくは、「OpenID Connect」をご覧ください。

GitHub Connect

企業が GitHub Connect を介して 1 つ以上の GitHub Enterprise Server インスタンスにリンクしている場合、スラッグを変更した後、GitHub Connect を無効化して再有効化することで、接続をリセットする必要があります。 詳しくは、GitHub Enterprise Server のドキュメントの「GitHub.com の GitHub Connect の有効化」を参照してください。

enterprise スラッグの変更

メモ

enterprise のスラッグを変更する前に、その変更による潜在的な影響を理解していることを確認してください。 詳しくは、「企業スラッグを変更するときの考慮事項」をご覧ください。

  1. 企業ページに移動してください。 たとえば、GitHub.com の [Enterprise] ページから。

  2. ページの上部にある [ Settings] をクリックします。

  3. ページの下部にある「Danger zone」（危険区域）セクションで、「Change enterprise URL slug」（企業 URL スラグを変更）をクリックします。

  4. 「企業 URL スラグの変更」ダイアログで指示に従って、企業スラグ URL を変更 をクリックします。