Opsgenie を Microsoft Active Directory と統合する
Opsgenie が Microsoft Active Directory ユーザーに提供するもの
Opsgenie は、Active Directory ユーザーとグループを Opsgenie と同期するためのユーティリティを提供します。このユーティリティを使用して、Opsgenie との同期を維持する Active Directory グループを選択します。
統合の機能性
ユーティリティを構成すると、選択した Active Directory グループと Opsgenie との同期が開始されます。Opsgenie に同じ名前のチームが存在しない場合、Active Directory グループ用のチームが Opsgenie に作成されます。次に、Active Directory グループのメンバーを Opsgenie のチームに追加します。ユーザーがまだ存在していない場合は、ユーザーを作成します。
このユーティリティは、Active Directory に電子メールアドレスが設定されている場合にのみ Opsgenie でユーザーを作成します。
If the "Apply Deletions" option is selected true in the configuration, it removes the users from synchronized teams in Opsgenie if they're removed from the Active Directory groups. Also, if the user doesn't exist in any of the other synchronized groups it deletes the user in Opsgenie. If the selected group doesn't have any members, the utility won't create the corresponding team in Opsgenie. If the group has created before but left with no members, the corresponding team is deleted in Opsgenie. All of these deletion operations depend on the apply deletions option. If it's false, no deletions occur.
インストール
ZIP パッケージはこちらからダウンロードしてください。
ZIP ファイルをディレクトリに解凍します。
activeDirectorySync.conf ファイルを編集して、ユーティリティを設定します。
設定ファイルのすべてのパラメーターについては、以下の「 設定」セクションの表で説明しています。
構成後、activeDirectorySync.exe を実行して同期を手動で開始するか、実行可能ファイルをスケジュール済みのタスクとして追加して同期を自動化します。以下の「同期プロセスの自動化」セクションを参照してください。
Windows では、ダウンロードした実行可能ファイルを自動的にブロックします。activeDirectorySync.ps1、activeDirectorySync.exe、activeDirectorySync_64.exe がブロックされている場合、ブロックを解除します。
ブロックを解除しないと、[AuthorizationManager のチェックに失敗しました] エラー メッセージがログ ファイルに発生する可能性があります。
ファイルを右クリックし、[プロパティ] を選択し、右下の [ブロック解除] オプションをオンにし、[OK] または [適用] ボタンをクリックしてブロックを解除します。
構成
このユーティリティは、同じディレクトリにある activeDirectorySync.conf ファイルを使用して、構成を読み込んで適用します。
このファイルを編集し、少なくとも必要なパラメーターを入力し、ファイルを保存して、Active Directory ユーザーとグループを正常に同期させます。
This utility requires an API Integration configured in Opsgenie. Either
create a new one and use its API key, or use an existing API integration.以下では、設定ファイルのすべてのパラメーターについて説明します。
パラメーター名 | 必須またはオプション | 説明 |
---|---|---|
ogUrl | 任意 | Opsgenie 環境が米国以外の場合、このプロパティの既定値を変更します。例えば、EU 環境では、https://api.eu.opsgenie.com をします。。指定しない場合、ユーティリティはアカウントが米国環境にあるものと仮定します。 |
ogApiKey | (必須) | このユーティリティを動作するには、Opsgenie での API 統合が必要です。統合には、config アクセスと書き込み権限があります。新しい API 統合を作成する代わりに、デフォルト API 統合の API キーを使用します。 |
logLevel | 任意 | ユーティリティが書き込むログの詳細を決定します。プロパティの既定値は警告です。サポートされているその他のレベルは、情報、デバッグとエラーです。最も詳細なレベルはデバッグです。ユーティリティによって生成されるすべてのログが印刷されます。 |
logPath | 任意 | Determines which path for which the log file is created. The default value is empty. Which means it is placed in the same path with the executable. It has the name activeDirectorySync.log |
groupsToSync | 任意 | The names of the Active Directory groups that are synchronized with Opsgenie teams. It's a comma separated property. Replace the [YOUR ACTIVE DIRECTORY GROUPS] placeholder value with the names of the groups to keep synchronized. For example, groupsToSync = Domain users, Domain guests, Administrators |
sendInvitationEmails | 任意 | true/false 値はユーティリティによって作成された招待メールを、ユーティリティがユーザーに送信するかどうかを決定します場合によっては、特にトライアル プロセスでは、実際の従業員に招待メールを送信する必要がない場合があります。プロパティの既定値は true です。 |
applyDeletions | 任意 | このユーティリティは、Active Directory から削除されたユーザー/チームの削除もサポートしています。しかし、削除は自動的に適用するには危険な操作であるため、ユーティリティにはこれを自動的に実行しないオプションがあります。有効化されていない場合、ユーティリティは Opsgenie にユーザー/チームのみを作成します。それは真/偽の値です。プロパティの既定値は false です。 |
http.proxy.enabled | 任意 | このプロパティは、プロキシ サーバー機能が有効かどうかを判定するためのものです。それは真/偽の値です。既定値は偽です。 |
http.proxy.port | 任意 | このプロパティは、プロキシ サーバーが実行されているポートを決定します。 |
http.proxy.host | 任意 | このプロパティは、プロキシ サーバーのドメインアドレスを決定します。既定値は localhost です。 |
http.proxy.procol | 任意 | このプロパティは、プロキシ サーバーが使用するプロトコルを決定します。サポートされている値は http または https です。既定値は http です。 |
http.proxy.username | 任意 | プロキシ サーバーの認証を使用する場合は、このプロパティにプロキシ サーバー ユーザーのユーザー名を入力します。既定値は管理者です。 |
http.proxy.password | 任意 | プロキシ サーバーの認証を使用する場合は、このプロパティにプロキシ サーバー ユーザーのパスワードを入力します。プロキシ サーバー ユーザーにパスワードが設定されていない場合は、このプロパティを空白のままにします。 |
同期プロセスの自動化
このユーティリティは、手動実行時に Active Directory のグループとチームのみを同期します。
同期を自動化するには、コマンド プロンプトで以下のコマンドを実行して、スケジュール済みのタスクを追加します。
テキスト
SchTasks /Create /SC MINUTE /MO 30 /TN "OpsGenie Active Directory Synchronization" /V1 /TR "C:\opsgenieActiveDirectorySync\activeDirectorySync.exe" /ST 15:00
このコマンドは、実行可能ファイル (C:\opsgenieActiveDirectorySync\activeDirectorySync.exe) が 15:00 から開始し、30 分 おきに実行するために、タスク スケジューラーに新しいスケジュール済みのタスクを作成します。
実行可能ファイルのパス、実行頻度、開始時刻を適宜変更します。
この内容はお役に立ちましたか?