edo-idp-selector

README

edo-idp-selector

ID プロバイダ選択サービス。

1. インストール

go が必要。 go のインストールは http://golang.org/doc/install を参照のこと。

go をインストールしたら、

go get github.com/realglobe-Inc/edo-idp-selector

適宜、依存ライブラリを go get すること。

2. 実行

以下ではバイナリファイルが ${GOPATH}/bin/edo-idp-selector にあるとする。 パスが異なる場合は置き換えること。

2.1. DB の準備

キャッシュやセッション用に [redis]、ID プロバイダ・TA 情報用に [mongodb] が必要になる。

mongodb への ID プロバイダ・TA 情報の同期は別口で行う。

2.2. UI の準備

選択 UI を edo-idp-selector で提供する場合は、適当なディレクトリに UI 用ファイルを用意する。

<UI ディレクトリ>/
├── select.html
...

UI ディレクトリは起動オプションで指定する。

2.3. 起動

単独で実行できる。

${GOPATH}/bin/edo-idp-selector

2.4. 起動オプション

オプション名	初期値	値
-uiDir		UI 用ファイルを置くディレクトリパス

2.5. デーモン化

単独ではデーモンとして実行できないため、Supervisor 等と組み合わせて行う。

3. 動作仕様

ユーザーに IdP を選択させて、その IdP にユーザーを受け渡す。

3.1. エンドポイント

エンドポイント名	初期パス	機能
開始	/start	ID プロバイダ選択機能を参照
選択	/select	ID プロバイダ選択機能を参照
選択 UI	/ui/select.html	ID プロバイダ選択機能を参照
ID プロバイダ列挙	/api/info/issuer	ID プロバイダ情報提供機能を参照

4. API

GoDoc

5. ライセンス

Apache License, Version 2.0