ユーザーのサスペンドとサスペンドの解除

一時停止されたユーザーについて

従業員が企業を退職した場合、そのGitHub Enterprise Serverアカウントをサスペンドすれば、GitHub Enterpriseライセンス中のユーザライセンスを空けながら、Issue、コメント、リポジトリ、Gist、そしてそのユーザが作成した他のデータを保持しておくことができます。 サスペンドされたユーザはインスタンスにサインインすることも、コードをプッシュやプルすることもできません。

ユーザをサスペンドした場合、その変更はすぐに有効になり、ユーザには通知されません。 ユーザがリポジトリからのプルやプッシュをしようとすると、以下のエラーが返されます:

$ git clone git@[hostname]:john-doe/test-repo.git
Cloning into 'test-repo'...
ERROR: Your account is suspended. Please check with
your installation administrator.
fatal: The remote end hung up unexpectedly

ユーザーを一時停止できないシナリオ

サイト管理者をサスペンドする前には、そのユーザを通常のユーザに降格させなければなりません。 「サイト管理者の昇格あるいは降格」をご覧ください。

特定の外部認証機能を使用する場合、サイト管理者ダッシュボードまたはコマンド ラインからユーザーの停止を管理することはできません。

• お使いの GitHub Enterprise Server インスタンス に対して LDAP 同期が有効になっている場合には、「LDAPの利用」で説明されているシナリオに基づいて、ユーザーは自動的に中断されます。
• SCIM プロビジョニングが有効になっている場合、SCIM プロビジョニングされたユーザーは、ID プロバイダーを通じて一時停止または停止解除する必要があります。

サイト管理者ダッシュボードで一時停止されたユーザーを表示する

1. GitHub Enterprise Server の管理アカウントから、任意のページの右上隅で をクリックします。
2. [サイト管理者] ページにまだ表示されていない場合は、左上隅の [サイト管理者] をクリックします。
3. 左側のサイドバーで、 [一時停止されたユーザー] をクリックします。
4. 一時停止されたユーザーのリストが表示されます。

サイト管理ダッシュボードからユーザを一時停止する

1. GitHub Enterprise Server の管理アカウントから、任意のページの右上隅で をクリックします。
2. [サイト管理者] ページにまだ表示されていない場合は、左上隅の [サイト管理者] をクリックします。
3. [ユーザー、Organization、チーム、リポジトリ、gist、アプリケーションを検索する] のテキスト フィールドに、ユーザーの名前を入力します。
4. テキスト フィールドの右側にある [検索] をクリックします。
   
   • 正確に一致するアカウント名が見つからない場合は、[検索結果 – アカウント] の [あいまい一致] セクションで、管理するユーザーの名前をクリックします。
     
5. サイト管理者ページでユーザーについて詳しく確認し、正しいユーザーを特定したことを確認します。
   
6. ページの右上隅にある [管理] をクリックします。
   
7. [アカウントの一時停止] の [危険ゾーン] セクションで、 [一時停止] をクリックします。
8. [ログの理由] フィールドに、ユーザーを一時停止する理由を入力します。
9. [一時停止] をクリックします。

サイト管理ダッシュボードからユーザのサスペンドを解除する

ユーザのサスペンドの場合と同じく、ユーザのサスペンド解除もすぐに有効になります。 ユーザには通知されません。

1. GitHub Enterprise Server の管理アカウントから、任意のページの右上隅で をクリックします。
2. [サイト管理者] ページにまだ表示されていない場合は、左上隅の [サイト管理者] をクリックします。
3. 左側のサイドバーで、 [一時停止されたユーザー] をクリックします。
4. サスペンドを解除したいユーザアカウントの名前をクリックします。
5. ページの右上隅にある [管理] をクリックします。
   
6. [アカウントの一時停止] の [危険ゾーン] セクションで、 [停止解除] をクリックします。
7. [ログの理由] フィールドに、ユーザーの停止を解除する理由を入力します。
8. [停止解除] をクリックします。

コマンドラインからユーザをサスペンドする

1. お使いの GitHub Enterprise Server インスタンス に SSH で接続します。 インスタンスが複数のノードで構成されている場合は (高可用性や geo レプリケーションが構成されている場合など)、プライマリ ノードに SSH 接続します。 クラスターを使用する場合は、任意のノードに SSH 接続できます。 HOSTNAME をインスタンスのホスト名、またはノードのホスト名または IP アドレスに置き換えます。 詳しくは、「管理シェル (SSH) にアクセスする」を参照してください。

   Shell

   ssh -p 122 admin@HOSTNAME
   

2. 一時停止するユーザー名を指定して ghe-user-suspend を実行します。

   ghe-user-suspend USERNAME
   

サスペンドされたユーザのためのカスタムメッセージを作成する

サスペンドされたユーザがサインインしようとしたときに表示されるカスタムメッセージを作成できます。

1. GitHub Enterprise Server の右上で、ご自分のプロフィール フォトをクリックしてから、 [Enterprise 設定] をクリックします。

   

2. ページの左側にある Enterprise アカウントのサイドバーで、 [設定] をクリックします。

3. [Settings] で、[Messages] をクリックします。

4. [一時停止されたユーザー ページ] の右側にある [メッセージの追加] をクリックします。

   

5. [ユーザーの一時停止メッセージ] フィールドに、メッセージを入力します。 Markdownをタイプするか、Markdownツールバーを使ってメッセージのスタイルを指定できます。

6. レンダリングされたメッセージを表示するには、 [プレビュー] をクリックします。

7. ページの下部にある [変更の保存] をクリックします。

コマンドラインからユーザのサスペンドを解除する

1. お使いの GitHub Enterprise Server インスタンス に SSH で接続します。 インスタンスが複数のノードで構成されている場合は (高可用性や geo レプリケーションが構成されている場合など)、プライマリ ノードに SSH 接続します。 クラスターを使用する場合は、任意のノードに SSH 接続できます。 HOSTNAME をインスタンスのホスト名、またはノードのホスト名または IP アドレスに置き換えます。 詳しくは、「管理シェル (SSH) にアクセスする」を参照してください。

   Shell

   ssh -p 122 admin@HOSTNAME
   

2. 停止解除するユーザー名を指定して ghe-user-unsuspend を実行します。

   ghe-user-unsuspend USERNAME
   

参考資料

• 「エンタープライズ ユーザー用の REST API エンドポイント」