GeneXus Access Manager(GAM) #1　概要・セットアップ

久方ぶりにGeneXusの仕事に携わるかもしれないため、GeneXus17のトライアル兼ね、いくつか気になる機能の実機検証をしてみることに。

# GAM概要
GAMの概要説明・GX Wiki関連文書へのインデックス
- [GeneXus Access Manager (GAM) (wiki.genexus.jp)](http://wiki.genexus.jp/hwiki.aspx?GeneXus+Access+Manager+(GAM))
- [GeneXus Access Manager (GAM) (wiki.genexus.com)](https://wiki.genexus.com/commwiki/servlet/wiki?24746,Toc%3AGeneXus+Access+Manager+%28GAM%29)）

ここではとりあえず認証（Authentication）機能周りを確認して参ります。
Authentication Typeとして以下等が列挙されています（今後検証するかもしれないものを抜粋）。

- Local　→　GAMのテーブルにクレデンシャルを格納するタイプ
- Facebook
- Twitter
- Google
- External　→　LDAP連携等？
- GAM Remote Rest Authentication type (Oauth 2.0)

# GAMセットアップ
## GAM有効化
- [GAMの使用 (wiki.genexus.jp)](http://wiki.genexus.jp/hwiki.aspx?GAM+%e3%81%ae%e4%bd%bf%e7%94%a8)
- [GAM Getting Started (wiki.genexus.com)](https://wiki.genexus.com/commwiki/wiki?19946,GAM+Getting+Started)

ナレッジベースのバージョンレベルのプロパティ「Enable Integrated Security」を「True」に設定します
（Tools > GeneXus Access Manager > Enable Integrated Security メニューの選択でも同じ）。

![GAMSetup01.JPG](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/168717/bf1b0f19-88ed-16e8-c8df-3d0f3e20f0ab.jpeg)

下記のダイアログが表示されます。
![GAMSetup02.JPG](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/168717/79af8c46-f3e8-8c26-9ff6-ba31bc105f98.jpeg)

Additional Cmponentsのところは「スマートデバイス用だ」とか、「SSO前提だ」とかシーンによって不要なもののチェックを外すための設定と思われます。後から削除もできるでしょうしここはいったんデフォルトで。

## 初期状態
- [GeneXus から初めて GAM リポジトリを作成する (wiki.genexus.jp)](http://wiki.genexus.jp/hwiki.aspx?GeneXus+%e3%81%8b%e3%82%89%e5%88%9d%e3%82%81%e3%81%a6+GAM+%e3%83%aa%e3%83%9d%e3%82%b8%e3%83%88%e3%83%aa%e3%82%92%e4%bd%9c%e6%88%90%e3%81%99%e3%82%8b)
- [GAM repository for the first time from GeneXus (wiki.genexus.com)](https://wiki.genexus.com/commwiki/servlet/wiki?29701,Creating+the+GAM+repository+for+the+first+time+from+GeneXus)

ざっくり、
- GAM関連の諸々のオブジェクトがインポートされ
- GAM用のデータストアが登録され
- 上述のEnable Integrated Security のところに関連プロパティが表示され
ます。

![GAMSetup03.JPG](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/168717/30461d07-8fad-ce69-38a1-0dfb8b8f10c0.jpeg) ![GAMSetup04.JPG](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/168717/def647df-a955-9f43-54ee-069f95260da4.jpeg)


## ビルド
この時点ではユーザ画面は何も作っていないので、Developer MenuにはGAM関連の画面のみ表示されます。
![GAMSetup05.JPG](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/168717/8392c64b-b8ff-6757-b110-4b215e5e13ad.jpeg)

このなかの「GAMHome」をクリックすると、ログイン画面が表示されます。Administratorのユーザ名、パスワードは「環境」のプロパティで設定できます。初期状態での設定値は以下参照。

- [[Administrator User Name] プロパティ (wiki.genexus.jp)](http://wiki.genexus.jp/hwiki.aspx?%5bAdministrator+User+Name%5d+%e3%83%97%e3%83%ad%e3%83%91%e3%83%86%e3%82%a3,)
- [[Administrator User Password] プロパティ (wiki.genexus.jp)](http://wiki.genexus.jp/hwiki.aspx?%5bAdministrator+User+Password%5d+%e3%83%97%e3%83%ad%e3%83%91%e3%83%86%e3%82%a3)
- [Administrator User Name property (wiki.genexus.com)](https://wiki.genexus.com/commwiki/servlet/wiki?15215,Administrator+User+Name+property)
- [Administrator User Password property (wiki.genexus.com)](https://wiki.genexus.com/commwiki/servlet/wiki?15216,Administrator+User+Password+property)

このユーザ名・パスワードでログインすると

![GAMSetup06.JPG](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/168717/0b7e6f19-c450-6533-b611-4dd6b5fb2031.jpeg)

以下の画面が表示され、「If you want to go to the GAM's Backend click here」の先が、GAM Local Authentication Typeにおけるユーザや権限の管理画面となります。

![GAMSetup07.JPG](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/168717/2370d36f-552b-b118-7d0b-dc34f2b65f4c.jpeg)
![GAMSetup08.JPG](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/168717/6819a0e8-2813-163b-554e-39a9e416d54f.jpeg)

この後の検証はこの管理画面で必要なユーザ等設定して進めます。

次回はGeneXusのWebアプリでGAMによる認証を求める方法を確認します
[GeneXus Access Manager(GAM) #2　ユーザアプリ認証設定（Web）](https://qiita.com/sgtrducky/items/076a0c19794af6b0b3c5)

2021年06月28日　初版