GitHub 認証モジュール
GitHub 認証モジュールを使用すると、ユーザーは GitHub アカウントの資格情報 (ユーザー名とパスワード) を使用して Space にログインできます。
GitHub 認証を有効にする
セットアップは、Space 側と GitHub 側の両方で 3 つの手順で実行されます。
Space からコールバック URL を取得します。この URL は、GitHub への各ログインリクエストのソースを識別するために Space によって生成されます。
コールバック URL を使用して、GitHub でクライアント ID とシークレットを生成します。Space から GitHub に送信されるすべてのログインリクエストには、一意の識別子が含まれます。認証モジュールに保存した ID とシークレットにより、各ログインリクエストが承認されていることを GitHub に伝えます。
クライアント ID とシークレットを Space に提供し、認証モジュールを有効にします。GitHub でクライアント ID とシークレットを生成したら、これらの値を Space に提供し、GitHub 認証モジュールを有効にします。
Space の GitHub 認証モジュールからコールバック URL を取得する
システム管理者として Space にログインします。
メインメニューで、
管理をクリックし、Auth モジュールを選択します。新しい認証モジュールをクリックします。新しい認証モジュールダイアログが開きます。
タイプドロップダウンリストから GitHub を選択します。
フォームのクライアント ID フィールドに表示されるコールバック URL をコピーします。
リンクをクリックして、GitHub の新しい OAuth アプリケーションを登録するページにアクセスします (新しいブラウザータブで開きます)。
GitHub アカウントにログインします (まだログインしていない場合)。新しい OAuth アプリケーションを登録するページが開きます。
GitHub でクライアント ID とシークレットを生成する
GitHub 新しい OAuth アプリケーションを登録するページで、新しい OAuth アプリケーションを登録するための一般パラメーターを指定します。
アプリケーション名 (Space)
ホームページ URL (Space の組織のエントリページ)
アプリケーションの説明 (オプション)
「認証コールバック URL」フィールドに、Space の GitHub 認証モジュールページからコピーしたコールバック URL を貼り付けます。
アプリケーション登録ボタンをクリックしてください。
GitHub は必要な認証情報 (クライアント ID とシークレット) を生成し、ポップアップウィンドウに表示します。
認証情報を提供し、Space で GitHub 認証モジュールを有効にする
GitHub からクライアント ID をコピーし、Space の GitHub 認証モジュールフォームのクライアント ID 入力フィールドに貼り付けます。
GitHub からクライアントシークレットをコピーし、Space の GitHub 認証モジュールフォームのクライアントシークレット入力フィールドに貼り付けます。
認証モジュールのオプション設定を行います。
モジュールのステータスをアクティブに切り替えます。
GitHub 認証モジュールが有効になっています。
GitHub アイコンがログインダイアログウィンドウに追加されます。ユーザーはこのアイコンをクリックして、GitHub 資格情報を使用して認証し、Space にログインできます。
GitHub の認証設定
設定 | 説明 |
|---|---|
タイプ | サードパーティ認証を処理するアプリケーションまたはサービスの名前。 |
状況 | アクティブを選択してモジュールを有効にします。 |
キー | モジュールの一意の識別子。デフォルトのキーをそのまま使用するか、新しいキーを指定します。 |
名前 | このモジュールを Auth モジュールリスト内の他の認証モジュールと区別するための人間が判読できる名前。デフォルトの名前をそのまま使用するか、新しい名前を入力します。 |
サーバー URL | ユーザーが GitHub 資格情報を使用してログインするときに、Space が認証のためにログインリクエストを送信するサーバー (GitHub または GitHub Enterprise) の URL。 |
クライアント ID | GitHub がログイン要求を検証するために使用する識別子を保存します。この値は、Web アプリケーションの認証設定を構成し、Space からコピーしたリダイレクト URI を入力すると、GitHub API Manager で生成されます。 |
クライアントシークレット | クライアント ID の検証に使用されるシークレットまたはパスワードを保存します。この値は、クライアント ID とともに GitHub API Manager で生成されます。 |
ユーザー登録 | オン - GitHub 認証モジュールを使用してログインする未登録ユーザーに対して、Space 組織内のアカウントが自動的に作成されます。 オフ - GitHub ログインは、Space 組織にすでにアカウントを持っているユーザーのみが利用できます。 |
認証を指定した GitHub 組織のユーザーに制限する | 選択すると、指定した GitHub 組織のユーザーのみがログインできるようになります。 許可される組織のコンマ区切りのリストを入力します。選択しない場合、GitHub アカウントを持つすべてのユーザーがこの認証モジュールを使用してログインできます。 |