チームとビジネス

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 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 のリスト

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

ヘルプを受ける

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

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