1PasswordEvents ReportingとElasticを使い始める

1Passwordマニュアル｜チームとビジネス向けに、1PasswordEvents ReportingとElasticの活用法を解説します。

チームとビジネス

1PasswordEvents ReportingとElasticを使い始める

1Password Events API Beat を使用して1PasswordアカウントのアクティビティをElasticsearchに送信する方法を紹介します。

1Password Businessでは、 1Password Events API Beat を使用してアカウントアクティビティをElasticsearchに送信できます。サインイン試行、アイテムの使用状況、監査イベントなどの1Passwordアクティビティに関するレポートを取得し、会社のすべてのアプリケーションとサービスを一元的に管理できます。1Password Events ReportingとElastic を1Passwordすると、次のことが可能になります。

• 1Passwordのデータ保持を管理する

• カスタムグラフとダッシュボードを構築する

• 特定のアクションをトリガーするカスタムアラートを設定する

• 1Passwordのイベントを他のサービスのデータと相互参照する

所有者、管理者、またはView Administrative Sidebar権限を持つグループのメンバーであれば、Events Reportingを設定できます。

ステップ1:Events Reporting統合を設定する

開始するには、 1Passwordアカウントにサインインし、サイドバーの「統合」をクリックして、 「Elastic」を選択します。

次に、次の手順に従って、 Elastic統合を1Passwordアカウントに追加し、ベアラー JSON Web トークンをCreateします。

1. 統合の名前を入力し、 「Add Integration」をクリックします。

2. ベアラー トークンの名前を入力し、有効期限を選択します。トークンがアクセスできるイベント タイプを選択し、 [Tokenの発行] をクリックします。

3. Save in 1Password」をクリックし、トークンをSaveする保管庫を選択します。次に、 「View Integration Details」をクリックします。

これで、ベアラー トークンを使用して、 Elasticsearchで1Password Events API Beat を認証できるようになりました。

ベアラートークンはいつでも発行または取り消すことができます。

ステップ2: 1PasswordアカウントをElasticに接続する

1Password Elastic統合または1Password Events API Beat のいずれかを使用して、 1PasswordアカウントをElasticに接続できます。

事前設定されたKibanaダッシュボードを使用して1Passwordアカウントのイベントを監視する場合は、 Elastic統合を使用する手順に従ってください。

コマンドラインからリクエストを実行して、 1PasswordアカウントからElasticsearchにイベント情報を送信する場合は、 Events API Beat を使用する手順に従ってください。

1Password Elastic Integrationを使用する

1Password Elastic統合には、少なくとも 1 つのElastic Agentがインストールおよび登録されたElastic StackとKibana 7.16 以降が必要です。

ステップ1: 1Password統合を追加する

1. Kibanaインスタンスにサインインし、ホームページに移動します。

2. メニューを開き、 「Management > Add integrations」に移動します。

3. 統合リストから1Password を選択し、 「1Passwordを追加」を選択します。

ステップ2: 1Password統合を設定する

1Password統合を追加した後、「統合の構成」セクションで設定を調整する必要があります。

1. 統合を識別するには、次のフィールドに入力します。

   • 統合名: 統合の名前を入力します。たとえば、1password などです。

   • 説明: (オプション) 統合の説明を入力します。

2. 1Password Events APIからイベントを収集する設定がオンになっていることを確認し、次のフィールドに入力します。

   • 1Password Events APIサーバーの URL:Events API URL を入力します。例: <a href="https://events.1password.com">https://events.1password.com</a> 。

   • 1Password Authorization Token: 1Passwordアカウントで統合を設定したときにSaveしたベアラー トークンを入力します。

3. 次の1Passwordイベントの 1 つ以上がオンになっていることを確認します。

   • 1Password監査イベントを収集する

   • 1Passwordアイテムの使用イベントを収集する

   • 1Passwordのサインイン試行イベントを収集する

4. 収集対象として選択したイベントは、ベアラー トークンのCreate時に選択したイベントと一致する必要があります。収集したくないイベント タイプがオンになっている場合は、オフにします。

5. (オプション) 元のイベントの生のコピーを保持する場合は、イベント タイプに対して [元のイベントを保持] をオンにします。

6. (オプション) イベント タイプのデフォルト設定を調整する場合は、そのイベントの詳細オプションを選択します。次のフィールドを変更できます。

7. 制限*: 各リクエストで取得するイベントの数を調整します。デフォルトの制限は 1000 です。

8. 1Password Events APIをクエリする間隔 *: GO 期間構文を使用してクエリ間隔を調整します。デフォルトの間隔は 10 秒です。

9. タグ: (オプション) フィルタリングや操Createの実行に役立つタグを追加します。

10. Processors: (Optional) Add processors to parse, filter, transform, and enrich data at the source. * 1Password Events API limits requests to 600 per minute and 30,000 per hour. プロセッサ: (オプション) ソースでデータを解析、フィルタリング、変換、強化するためのプロセッサを追加します。 * 1Password Events API、リクエストが 1 分あたり 600 件、1 時間あたり 30,000 件に制限されます。

ステップ3: Elasticエージェントポリシーを選択する

Elasticエージェント ポリシーは、 Elastic Agentが収集するデータを定義します。[この統合を追加する場所] セクションで、次の手順に従います。

1. 統合に使用するエージェント ポリシーを選択します。

   • 新しいエージェント ポリシーをCreateする場合は、[新しいホスト] を選択し、ポリシーの名前を入力します。

   • 保存済みのポリシーを使用する場合は、「保存済みのホスト」を選択し、使用するエージェント ポリシーを選択します。

2. 「Saveして続行」を選択します。

3. [変更をSaveして展開] を選択し、変更がSaveされるまでしばらく待ちます。

1Password統合はインストールされた統合に含まれるようになり、統合に組み込まれたKibanaダッシュボードにアクセスして、 1Passwordアカウントからのイベントを監視できるようになります。返されるデータは、 Elastic Common Schema仕様に従います。

Elastic Agents のインストール方法について詳しくは、こちらをご覧ください。

1Password Events APIを使用する

1Password Events API Beat は、Events APIへのリクエストを通じて1Passwordから情報を返し、そのデータを安全にElasticsearchに送信します。リクエストはベアラー トークンで認証されます。使用するアプリケーションまたはサービスごとにトークンを発行します。

1PasswordアカウントをElasticに接続するには:

1. 1Password GitHubリポジトリから1Password Events API Elastic Beat をダウンロードしてインストールします。

2. eventsapibeat-sample.yml 構成ファイルの名前を eventsapibeat.yaml に変更します。

3. Beat の YAML ファイルを設定します。

   • 監視する1Passwordイベント タイプごとに、auth_token フィールドにベアラー トークンを追加します。

   • イベントをElasticsearchに直接送信するか、 Logstash、コンソールなどを介して送信するように出力を構成します。
   • 必要に応じてその他の構成オプションをカスタマイズします。

4. 次のコマンドを実行します。

 ./eventsapibeat -c eventsapibeat.yml -e ./eventsapibeat -c eventsapibeat.yml -e

5. これで、 Elasticsearch を1Password Events API Beat と組み合わせて使用​​し、 1Passwordアカウントのイベントを監視できるようになりました。返されるデータはElastic Common Schema仕様に従います。

付録: ベアラートークンの発行または取り消し

無記名トークンを発行する

1. 1Password.comのアカウントにサインインし、サイドバーの「統合」をクリックします。
2. トークンを発行するEvents Reporting統合を選択し、 「Add a token」をクリックします。

3. ベアラー トークンの名前を入力し、有効期限を選択します。トークンがアクセスできるイベント タイプを選択し、 [Tokenの発行] をクリックします。

4. Save in 1Password」をクリックし、トークンをSaveする保管庫を選択します。次に、 「View Integration Details」をクリックします。

ベアラートークンを取り消す

重要: トークンが取り消されると、 Elasticsearch はイベントの取り込みを停止します。ダウンタイムを最小限に抑えるには、トークンを取り消す前に代わりのトークンを発行してください。

1. 1Password.comのアカウントにサインインし、サイドバーの「統合」をクリックします。
2. トークンを取り消すEvents Reporting統合を選択します。

3. 取り消したいトークンの横にある歯車ボタンをクリックし、「取り消し」をクリックします。

Elasticでベアラートークンを更新する

1Passwordで新しいベアラートークンを発行する場合は、eventsapibeat.yml ファイルでトークンを更新し、Beat を再起動する必要があります。

付録: 1Passwordサーバー URL のリスト

アカウントがオンになっている場合:	Events API URL は次のとおりです:
1Password.com	<a href="https://events.1password.com">https://events.1password.com</a> (1Password Business) <a href="https://events.ent.1password.com">https://events.ent.1password.com</a> (1Password Enterprise)
1Password.ca	https://events.1password.ca
1Password.eu	https://events.1password.eu

付録: 1Passwordイベントタイプのリスト

イベントタイプ	説明
監査イベント	アカウント、保管庫、グループ、ユーザーなどに加えられた変更など、 1Passwordアカウントでチーム メンバーが実行したアクションに関する情報を返します。
アイテムの使用	共有保管庫内で変更、アクセス、または使用されたアイテムに関する情報を返します。
サインイン試行回数	サインイン試行 (Create功および失敗) に関する情報を返します。

ヘルプを受ける

トークンがアクセスできるイベント タイプを変更するには、新しいトークンを発行します。

Events Reportingに関するサポートを受けたり、フィードバックを共有したりするには、 1Password Businessチームにお問い合わせください。