PAM360 ソフトウェア開発キット

PAM360 ソフトウェア開発キット (SDK) は、PAM360 エコシステムを使用してアプリケーションを作成するためにカスタマイズされた、事前定義された一連のソフトウェア要件を開発者に提供します。PAM360 SDK は、ライブラリのコレクションと綿密なドキュメントを提供することで、開発者が特定のプラットフォーム、オペレーティング システム、プログラミング言語、またはフレームワークと互換性があり、PAM360 から実行する必要がある特権操作を備えたアプリケーションを構築するのに役立ちます。

包括的な範囲をカバーする SDK には、PAM360 REST API コーディング例の豊富なリポジトリが含まれており、特権アクセス管理機能をカスタム アプリケーションにシームレスに統合できます。開発プロセスを効率化するように設計された SDK は、再利用可能なコンポーネントとリソースを開発者に提供し、PAM360 内でのリソース アクセス、アカウント管理、ユーザー操作などの複雑なタスクを簡素化します。

SDK は、REST API に直接アクセスするためのコードを記述することなく、アプリケーションやマイクロサービスなどのスクリプトを記述して PAM360 の特権情報にアクセスできるようにするために作成されました。SDK を活用することで、開発者は特権アクセス管理機能をアプリケーションに効率的に組み込むことができ、PAM360 環境内での堅牢なセキュリティとシームレスな機能を確保できます。

このヘルプ ドキュメントでは、PAM360 ユーザー向けに SDK を設定し、目的のエンドポイントに展開する手順について説明します。以下のトピックをカバーします。

  1. SDK 用語集
  2. SDK のロールと権限
  3. SDK 環境要件
  4. PAM360 SDK ファイル
  5. PAM360 で SDK 用のポリシーを登録する
  6. サービス/アプリケーションへの PAM360 SDK の導入
  7. SDK アプリケーション管理

1.SDK 用語集

用語

説明

認証トークン

ユーザー作成時に生成される固有のトークンで、許可された SDK 機能を使用して PAM360 にアクセスするために使用されます。

SDK ポリシー

SDK がデプロイされたアプリケーションで、ユーザーにそれぞれの PAM360 アクセス権を付与するためのマッピング方法です。

登録トークン

ポリシー作成時に生成されるトークンです。このトークンは、ユーザーが SDK でデプロイされたアプリケーションを PAM360 に登録し、アプリケーション内で許可された PAM360 特権アクションにアクセスするために使用します。

アプリケーション

PAM360 ユーザーによって SDK がデプロイされる、あらゆるソフトウェアまたはサービスです。



2.SDK のロールと権限

PAM360 ユーザーは、管理者によってアクセス権が付与されており、かつユーザーアカウントにマッピングされた登録済みポリシーを通じて取得した登録トークンを所持している場合に、SDK を利用できます。ユーザーへの SDK アクセス権の付与、SDK 使用のためのポリシーの作成、および PAM360 にデプロイされた SDK アプリケーションの管理を行うには、次のいずれかのロールを持っている必要があります。

  1. 特権管理者
  2. 管理者
  3. カスタムロール（「SDK Application Management」操作が有効になっているもの）

3.SDK 環境要件

SDK を効果的に活用するために、必要に応じて次の前提条件が満たされていることを確認してください。

  1. PAM360 バージョン: SDK は PAM360 バージョン 6700 以降と互換性があり、SDK バージョン 1.0.00 以降が必要です。
  2. 開発環境：
    1. Java SDK: Java SDK にはバージョン 8 以上の Java アプリケーションが必要です。
    2. Python SDK: Python SDK にはバージョン 3.12 以降の Python アプリケーションが必要です。

4.PAM360 SDK ファイル

PAM360 は、開発活動を支援するために次の SDK ファイルを提供しています。

4.1 Java SDK

PAM360インターフェースで「管理」>>「開発者スペース」>>「SDK Management」に移動し、Java SDKをダウンロードします。

SDK JAR：このコアコンポーネントには、開発者がプロジェクトに統合できるPAM360 APIのプリコンパイル済みJavaクラスおよびメソッドが含まれています。さまざまなクラス ファイル、リソース、および依存ライブラリを含む圧縮パッケージのように機能します。

注記：このバージョンでは、コア SDK のみがダウンロードされます。プロジェクトの参照ライブラリに次の JAR を含めます。commons-logging-1.1.jar, httpclient-4.5.13.jar, httpcore-4.4.9.jar, httpmime-4.5.3.jar, json.jar。

4.2 Python SDK

PAM360 Python SDKにアクセスするには、PAM360インターフェースで「管理」「開発者スペース」>>「SDK Management」に移動し、Python SDKをダウンロードします。

SDKパッケージ：Python SDK は、フォルダ内に構造化された必要なインストール可能な SDK パッケージを含む圧縮された zip ファイルとしてバンドルされています。SDK パッケージ内の[pyproject.toml]ファイルにはインストール仕様が記載されています。さらに、[src]フォルダ内には、PAM360 API との統合に不可欠な Python SDK ソース ファイルがあります。

注記：SDKのインストール後、requestsライブラリのバージョン2.31.0以降（https://pypi.org/project/requests/）がインストールされていることを確認してください。

5.PAM360 で SDK 用のポリシーを登録する

PAM360 SDK をアプリケーションに統合するには、まず必要な SDK ファイルを入手する必要があります。さらに、管理者は PAM360 に SDK ポリシーを登録し、それを PAM360 ユーザーのアカウントにマッピングする必要があります。このマッピングは、SDK で展開されたアプリケーションで必要な PAM360 アクセスを提供するブリッジとして機能します。ポリシーに関連付けられた登録トークンは、SDK で展開されたアプリケーションから PAM360 へのユーザー認証を許可します。

メモ：

  • ポリシーが作成されるユーザーは、PAM360 SDKアクセス権を持つユーザーアカウントを所有している必要があります。
  • ユーザーは、PAM360で付与されたロールとスコープに基づき、SDKの定義済みクラスおよびメソッドを使用して、アプリケーション内でPAM360 APIにアクセスできます。たとえば、「パスワードユーザー」のロールを持つユーザーは、管理者によって共有されたリソースおよびアカウントに関連するAPI操作のみをアプリケーション/サービス内で使用できます。

SDKアクセス権を持つユーザーのポリシーを登録する方法

  1. [管理] >> [開発者スペース] >> [SDK Management] に移動します。このページには、関連付けられているユーザー、アクセス ステータス、許可されたホスト名などの詳細を含む既存のポリシーのリストが表示されます。
  2. ［Policies］タブから [追加] をクリックして新しいポリシーを作成します。
  3. 開いたダイアログボックスで、
    1. ポリシー名：ポリシーに対してわかりやすい名前を入力します。
    2. Associated User: PAM360 SDK を使用してアプリケーション内で PAM360 操作を実行するためのポリシーが作成されるユーザーを選択します。
  4. 登録トークンを作成するには、[生成]をクリックします。
  5. 「保存」をクリックします。ポリシーを保存すると、関連付けられたユーザーに、SDK をさらに使用するための登録トークンが記載されたメールが送信されます。
    sdk-1

5.1 SDKポリシー管理

PAM360 コンソールを使用すると、管理者は既存のポリシーに対して次のアクションを実行できます。

  1. ポリシーの詳細を編集
  2. 登録トークンを再生成
  3. ポリシーを削除

メモ：

  • SDK ポリシーを削除すると、そのポリシーに関連付けられている登録済みアプリケーションがすべて削除されます。
  • SDK ポリシーごとのアプリケーションの数は、PAM360 でのユーザーのロールに基づいて制限されます。管理者タイプのロールを持つユーザーは、SDK ポリシーごとに最大 3 つのアプリケーションを登録できます。エンドユーザー タイプのロールを持つユーザーは、SDK ポリシーごとに最大 10 個のアプリケーションを登録できます。

5.2 SDKポリシーの仕組み

ユーザーがSDKをデプロイすると、SDKがデプロイされたアプリケーションからリクエストを送信する際、PAM360は登録トークンに関連付けられたリクエストのソースを、PAM360でユーザーに関連付けられたポリシーと照合して検証し、PAM360インターフェースへの正当かつ認可されたアクセスを提供します。

6.サービスまたはアプリケーションへのPAM360 SDKのデプロイ

上記の管理タスクを完了すると、ユーザーは希望するプログラミング サービスまたはアプリケーション内で PAM360 SDK の使用を開始できます。以下は、PAM360 SDK を関連する DevSecOps サービスまたはアプリケーションに展開および登録するために必要なドキュメントとガイドライン、およびサンプル API コードです。

DevSecOps 向け PAM360 ソフトウェア開発キット: Java | Python

7.SDK アプリケーション管理

PAM360 SDK と登録トークンを使用してユーザーが登録したすべてのアプリケーションが、関連情報とともにここにリストされます。それぞれの権限を持つユーザーは、PAM360 インターフェースから直接、PAM360 に登録されたアプリケーションのリストを表示および管理できます。

PAM360でこの機能にアクセスするには、「管理」 >> 「開発者スペース」 >> [SDK Management] >> [Applications]に移動します。

  1. ナビゲーションすると、PAM360 SDK がデプロイされているアプリケーションのリストがページに表示されます。各アプリケーション エントリには、登録されたポリシー名、Application Type、最終アクセス、アクション、Hostname、Registered IP、作成時刻、メモなどの情報が含まれます。
    sdk-2
  2. 管理者は、[アクション]の下にある [SDK Audit] ボタンを使用して、アプリケーションで実行されたすべての PAM360 操作を追跡できます。これにより、SDK がデプロイされたアプリケーションから直接実行されたアクティビティの監査証跡が提供されます。
    sdk-3
  3. 管理者はアプリケーションを削除することもでき、これにより登録されたアプリケーションから SDK のリンクが解除されます。アプリケーションを削除すると接続が削除され、再登録しない限りアプリケーションは PAM360 からデータを取得できなくなります。
  4. さらに、管理者はアプリケーション名を編集し、すばやく識別して参照できるようにメモを追加できます。
Java SDK の実装
Python SDK の実装