Googleグループ情報をCloudGate UNOに取り込む
目次
3.OAuth設定
3-1.サービスアカウントとキーの作成
4.ダウンロードツールの設定
4-1.ツールのダウンロード
4-2.ツールの設定
5.Googleグループのダウンロード
5-1.Googleグループのダウンロード
5-2.トラブルシューティング
6.グループの登録
6-1.グループの登録
1.はじめに
1-1.このガイドの対象
このガイドは、『グループ管理』オプションまたは、基本プランの「Standard Plan」または、「Enterprise Plan」をご契約いただいているお客様を対象としています。
1-2.目的と内容
『Googleグループ一括登録機能』はこれまでGoogleグループを登録・更新・削除するための一括登録機能としてご提供して参りましたが、 今後Google以外のクラウドサービスとも連携できるよう、 今回のバージョンアップでは、CloudGateから各クラウドサービスに応じた グループ情報を一括管理出来る機能をリリースいたします。
これに伴い、CloudGate UNO管理者サイトにグループ管理メニューが追加され、一括登録用のcsvフォーマットが変更となります。
また、バージョンアップ直後はCloudGate側のグループ情報が空の状態のため、CloudGate UNO管理者サイトのグループ管理をご利用いただくには、 CloudGate側にグループ情報を登録する必要がございます。
このガイドでは、Googleからグループ情報を取得する手順とCloudGate側へのグループ登録手順を解説いたします。
ご利用のお客様にはお手数をお掛けしまして申し訳ございませんが、作業にご協力いただけますようお願いいたします。
2.利用環境
2-1.利用環境
PCのOS：Windows
必要なアプリケーション：JRE 8 (Java SE 8) ※詳細は「2-2.Javaの確認」をご参照ください。
2-2.Javaの確認
こちらで提供するツールを動かすためには、最新版のJava（version8）が必要です。
ご利用のPCに最新版のJavaがインストールされていない場合は、こちらからダウンロードをお願いします。
＜最新版のJavaがインストールされているかどうかを確認する方法＞
(1)コマンドプロンプトを起動します。
(2)Javaのバージョンを確認するコマンドを入力します。
(3)表示された結果を確認します。
1.コマンドプロンプトを起動します。
Windowsのスタートメニュー＞検索＞「cmd」を入力して、コマンドプロンプトを起動します。
2.Javaのバージョンを確認するコマンドを入力します。
java -version
上記をコピーして、コマンドプロンプトの画面でペーストします。
Enterキーをクリックします。
3.結果を確認します。
Javaのversion8がインストールされている場合：
Javaのバージョンが”1.8.0_☓☓”と表示されれば問題ありません。
”1.8.0_☓☓”以外の場合は、最新版のJavaをインストールします。
Javaがインストールされていない場合：
Javaがインストールされていない場合は、最新版のJavaをインストールします。
Javaダウンロード： https://java.com/ja/download/
3.OAuth設定
3-1.サービスアカウントとサービスアカウントキーの作成
OAuth設定手順
上記サイトに移動して設定を行います。
「3-1.OauthのクライアントID作成」で作成した以下の情報は、後の作業で必要になりますので大切に保管してください。
- サービスアカウントキー「CloudGate-**************.json」のファイル
- サービスアカウント(メールアドレス)の値
4.ダウンロードツールの設定
4.1ツールのダウンロード
Googleグループ情報を取得するためのツールをダウンロードします。
4.2-ツールの設定
zipファイルを解凍します。
【google-group-download】フォルダには、以下のファイルが保存されています。
「3-1.サービスアカウントとサービスアカウントキーの作成」でダウンロードした「.json」ファイルを同じフォルダに保存します。
「default.properties」をワードパッド、サクラエディタ、秀丸などのテキストエディタで開きます。
Microsoft メモ帳はご利用いただけません。
情報を入力します。
(1)【default_account】API連携用のGoogle管理者IDを入力します。
(2)【default_service_account】「サービスアカウントID」を入力します。※
(3)【default_key_alias】何も入力しないでください。
(4)【default_key_pass】何も入力しないでください。
(5)【default_key_path】プライベートキー「CloudGate-**************.json」のファイル名を入力します。
※ 「3-1.サービスアカウントとサービスアカウントキーの作成」で取得したサービスアカウントIDです。
5.Googleグループのダウンロード
5.1Googleグループのダウンロード
【google-group-download】フォルダ内にある「run.bat」をダブルクリックします。
画面が起動して、グループダウンロード処理が始まります。
※全てのGoogleグループがダウンロード処理が完了するまで時間がかかります。
処理が完了すると、画面が閉じて、【google-group-download】フォルダにcsvファイルがダウンロードされます。
ダウンロード操作は完了です。
グループ一括登録は、CloudGate UNO管理者サイトで行います。
5.2トラブルシューティング
csvファイルがダウンロードできない場合、以下の内容をご確認ください。
(1)プライベートキー「CloudGate-*******.json」が保存されているフォルダを確認します。
「google-group-download.jar」「run.bat」と同じフォルダーに保存されているかご確認ください。
(2) default.properties の設定内容に誤りがないか。
余分なスペースが入っていたり、ファイル名が異なっているとツールは正常に動作しません。4.2-ツールの設定の設定内容をもう一度ご確認ください。
(3)「default.properties」をメモ帳で編集していないか。
Microsoft メモ帳はご利用いただけませんのでご注意ください。ワードパッド、サクラエディタ、秀丸などのテキストエディタで編集してください。
6.グループの登録
6.1グループの登録
(1)ダウンロードしたcsvを編集します。
(2)csvをアップロードします。
(3)CloudGate UNO管理者サイトにグループが登録されていることを確認します。
1.ダウンロードしたcsvを編集します。
「5.1Googleグループのダウンロード」でダウンロードしたcsvを、Googleスプレッドシートもしくはテキストエディタで開きます。
編集方法は、CloudGate UNO管理者サイトのオンラインヘルプをご参照ください。
「groupId」が空欄でダウンロードされます。
「groupId」は今回のバージョンより、CloudGateグループ管理画面でのグループIDとして利用され、GoogleグループIDとしては利用されません。
「groupId」 の記入形式が以下の通り、変更されます。
レルムは、CloudGate UNO管理者サイト＞「レルム管理」よりご確認ください。
googleGroupIdの@以降をCloudGateのレルムに変更して、「groupId」項目に入力します。
2.csvをアップロードします。
1.で編集したcsvファイルをCloudGate UNO管理者サイトの一括登録画面からファイルをアップロードして、
「状況確認」タブより実行をおこなってください。
3.CloudGate UNO管理者サイトにグループが登録されていることを確認します。
CloudGate UNO管理者サイト ＞グループ にグループが登録されています。
