チームコマンド

Keeper SDK向けチーム関連コマンドの説明

概要

チームを作る目的は、ユーザーがボルト内のレコードやフォルダを、論理的なユーザーグループと共有できるようにすることです。管理者はチームを作成し、チーム制限 (パスワードの編集/閲覧/共有など) を設定し、ユーザーをチームに追加します。ユーザーは手動で追加するか、いくつかの自動化された方法でチームに追加できます。

チームを使うと、ユーザーのグループ全体にロールを一括で割り当て、適用ポリシーの一貫性を保ちやすくなります。詳細はこちらをご参照ください。

チーム関連のコマンドは次のとおりです。

1. エンタープライズチーム
2. チーム一覧コマンド
3. チーム取得コマンド

コマンド

チーム一覧コマンド

このコマンドは、ログイン中のユーザーがアクセスできる各チームのUIDと名前を一覧表示します。

DotNet CLI

コマンド: list-team

説明: Keeperボルトで利用可能なチームの一覧を表示する。

パラメータ:

必須パラメータなし

オプション:

オプション	説明
-v, --verbose	出力にチームのメンバー情報を含める
--very-verbose	キャッシュにない詳細なメンバー情報を取得する (--verbose より網羅的)
-a, --all	プライマリ組織外も含め、連絡先のすべてのチームを表示する
--sort	列でソート: company、team_uid、name (既定: company)

例:

My Vault> list-team
Found 1 team(s).

     Company          Team UID                      Name
---  ---------------  ----------------------------  ------------------
  1  Acme Corp        AbCdEfGhIjKlMnOpQrStUvWxYz     Engineering Team

My Vault> list-team --verbose
Found 2 team(s).

     Company          Team UID                      Name              Members
---  ---------------  ----------------------------  ----------------  ---------------------
  1  Acme Corp        AbCdEfGhIjKlMnOpQrStUvWxYz     Engineering Team  [e-mail]
                                                                       [e-mail]
  2  Acme Corp        BcDeFgHiJkLmNoPqRsTuVwXyZa     Marketing Team

DotNet SDK

メソッド:

Task<List<TeamListItem>> GetTeamList(TeamListOptions options = null, Action<Severity, string> logger = null);

引数:

引数	型	必須	説明
options	TeamListOptions	いいえ	チーム一覧生成のオプション (既定: null = 既定オプション)
logger	Action<Severity, string>	いいえ	操作中のログメッセージ用コールバック (既定: null)

TeamListOptions のプロパティ:

プロパティ	型	既定	説明
Verbose	bool	false	チームのメンバー情報を表示する
VeryVerbose	bool	false	キャッシュにないメンバー情報を取得する
ShowAllTeams	bool	false	プライマリ組織外のチームも含めて表示する
SortBy	string	"company"	ソート列: "company"、"team_uid"、"name"

戻り値:

Task<List<TeamListItem>> — TeamListItem の一覧を返すタスク

TeamListItem のプロパティ:

プロパティ	型	説明
TeamUid	string	チームの一意識別子
Name	string	チームの表示名
Company	string	エンタープライズ/組織名
Members	List<string>	メンバーのメールアドレス一覧 (verbose モードでのみ設定される)

使用例:

var teams = await vault.GetTeamList();
foreach (var team in teams)
{
    Console.WriteLine($"{team.Company} - {team.Name}");
}

Power Commander

コマンド: Get-KeeperEnterpriseTeams [-ShowMembers] [-ShowAllMembers] [-All] [-Sort <company|team_uid|name>]

パラメータ

パラメータ	説明
ShowMembers	キャッシュからメンバーを表示する (高速だが不完全な場合あり)。別名: -v
ShowAllMembers	メンバーを表示し、キャッシュが空のときサーバーから取得する (低速だが完全)。別名: -vv
All	管理対象企業のチームを含める (MSP管理者)。別名: -a
Sort	ソート: company、team_uid、name。

例

PS PowerCommander> Get-KeeperEnterpriseTeams -ShowAllMembers

Found 6 team(s).


# Company         Team UID               Name         Member
- -------         --------               ----         ------
1 acmeol Security qwSIvyUz9n3fwwSfEYeivz example team [e-mail]
2 acmeol Security lZwPcTjsBgCwewWzb7kP1Q H1           [e-mail]
3 acmeol Security QVTP0wK_4boCD3VpzJ55ng NewTeam1     [e-mail]
4 acmeol Security e5fcHJEMxEUAdeAKS_x-AQ PCTeam2      
5 acmeol Security 2gHgptWRRmWAweCRgRhuuw PCTeam2      
6 acmeol Security qS9qkAwwee2vl6o5UJggaagA POD Team     

PS /Users/satish/Desktop/SDK-DotNet-rebase/keeper-sdk-dotnet/PowerCommander> Get-KeeperEnterpriseTeams -All           

Found 6 team(s).


# Company         Team UID               Name
- -------         --------               ----
1 acmeol Security qwSIvyUzef3gNSQEYeivzQ example team
2 acmeol Security lZwPcTjsBgCq12Wzb1kP1Q H1
3 acmeol Security QVTPefK_4boM_vVpzJ55ng NewTeam1
4 acmeol Security e5fcHJEMxEU9-UAK11x-AQ PCTeam2
5 acmeol Security 2gHgptWRRmWywhCwfRhuuw PCTeam2
6 acmeol Security qS9qkAme2vl6o5UJ3faagA POD Team

Python CLI

コマンド: list-team

パラメータ:

• --format 出力形式 - Table、csv、json
• --output 出力先ファイルのパス ("table" 形式では無視)
• --sort 列でソート company、uid、name (既定: company)

フラグ:

• -v, --verbose 詳細出力 (チームのメンバー情報を含む)
• -vv, --very-verbose キャッシュにないチームのメンバー情報を取得する
• -a, --all 連絡先のすべてのチームを表示する (プライマリ組織外を含む)

例:

My Vault> list-team
  #  Company          Team UID                Name
---  ---------------  ----------------------  -------------------
  1  Keeper Security  team_uid                example team

Python SDK

関数: load_available_teams

vault_utils.load_available_teams(auth=vault.keeper_auth)

チーム取得コマンド

単一チームの詳細 (プロパティおよびメンバー情報を含む) の参照。管理者以外のユーザーでも利用できます。チーム管理コマンドについては、エンタープライズチームコマンドをご参照ください。

DotNet SDK

メソッド:

Task<IReadOnlyList<TeamMemberInfo>> GetTeamMembers(string teamUid);

引数:

引数	型	必須	説明
teamUid	string	はい	チームUID

TeamListOptionsプロパティ:

プロパティ	型	説明
EnterpriseUserId	long	エンタープライズユーザーID
Email	string	チームメンバーのメールアドレス
EnterpriseUsername	string	エンタープライズユーザー名
IsShareAdmin	bool	ユーザーがチーム共有管理者かどうか

戻り値:

Task<IReadOnlyList<TeamMemberInfo>>。vault/get_team_members API から取得したチームメンバー。チームにメンバーがいない場合は空のリストを返します。

TeamListItemプロパティ:

プロパティ	型	説明
TeamUid	string	チームの一意識別子
Name	string	チームの表示名
Company	string	エンタープライズ/組織名
Members	List<string>	チームメンバーのメールアドレス一覧 (詳細モードでのみ設定)

使用例:

// Resolve team from vault or enterprise data
Team team = null;
if (!vault.TryGetTeam(teamNameOrUid, out team))
{
    // For enterprise admins, resolve from EnterpriseData
    enterpriseData.TryGetTeam(teamNameOrUid, out var enterpriseTeam);
}

var teamUid = team?.TeamUid ?? enterpriseTeam?.Uid;
var members = await vault.GetTeamMembers(teamUid);

foreach (var member in members)
{
    Console.WriteLine($"{member.Email}  Share Admin: {member.IsShareAdmin}");
}