エンタープライズチームコマンド

エンタープライズチームの管理

使い方

enterprise-team command [--options] OR et command [--option]

エイリアス: et

コマンド一覧

コマンド	説明	エイリアス
view	エンタープライズチームを参照します。	v
add	エンタープライズチームを作成します。	a
edit	エンタープライズチームを編集します。	e
delete	エンタープライズチームを削除します。	d
membership	エンタープライズチームのメンバーシップを管理します。	m

チームの参照

チームとその権限を参照します。

DotNet CLI

コマンド: enterprise-team view <team_name> または et view <team_name>

パラメーター:

team_name チーム名 (必須)

オプション:

• -q, --queued - 一覧/参照時にキュー済みのチーム/ユーザー情報を含める

例:

My Vault> enterprise-team view "POD Team"           
      Team Name:  POD Team                       
       Team UID:  qS9qkAme2vl6o5UJggaagA         
  Restrict Edit:  No                             
 Restrict Share:  No                             
  Restrict View:  No                             
          Users:  [email protected]
                  [email protected]  
   Queued Users:                                 
           Node:  Metron Security 

DotNet SDK

メソッド: EnterpriseData.Teams

使い方: EnterpriseData からチーム一覧を辞書として取得できます。

例:

var enterpriseTeam = EnterpriseData.Teams.FirstOrDefault(x =>
                    string.Compare(x.Name, identifier, StringComparison.CurrentCultureIgnoreCase) == 0);

PowerCommander

コマンド: Get-KeeperEnterpriseTeam

構文:

Get-KeeperEnterpriseTeam

エイリアス: ket

例:

# すべてのチームを一覧
PS> Get-KeeperEnterpriseTeam
PS> ket

コマンド: Get-KeeperEnterpriseTeamUser

パラメーター:

-Team : チームのユーザーを絞り込む名前またはUID。

構文:

Get-KeeperEnterpriseTeamUser

例:

# 特定のチームの全ユーザーを取得
PS> Get-KeeperEnterpriseTeamUser T

Id             DisplayName  Email                         UserStatus NodeName        
--             -----------  -----                         ---------- --------        
70411693850788 test sso     [email protected]         Active     SSO
70411693853106 Test1        [email protected]          Active     Keeper Security 

コマンド: Get-KeeperAvailableTeam

例:

PS > Get-KeeperAvailableTeam 

TeamUid                Name
-------                ----
eun1B5Cy89qO-sknhz59tg T3
7Xo__xOv62mUmqhXVPSZng Test Role Copy

Python CLI

コマンド: enterprise-team view

フラグ:

• -v, --verbose - 詳細情報を出力する

• --format - 出力形式: json

• --output - 出力ファイル名

• team - チーム名またはUID (必須)

Python SDK

関数:

team_id = 'チーム名またはUID'
team = enterprise_data.teams.get_entity(team_id)
if not team:
    ts = [x for x in enterprise_data.teams.get_all_entities() if x.name.lower() == team_id.lower(

チームの追加

エンタープライズチームを作成します。

DotNet CLI

使い方

enterprise-team  add [team] [--options] OR et add [team] [--options]

パラメーター:

team チーム名

オプション:

• --node <node> - ノード名またはID (追加/更新時)

• --restrict-edit <ON|OFF> - レコードの編集を無効にする

• --restrict-share <ON|OFF> - レコードの再共有を無効にする

• --restrict-view <ON|OFF> - パスワードの表示/コピーを無効にする

例:

# Add team
enterprise-team add "Frontend Team" --node "Engineering"
OR 
et add "Backend Team" --node 12345 --restrict-edit OFF --restrict-share ON

DotNet SDK

メソッド: CreateTeam

public async Task<EnterpriseTeam> CreateTeam(EnterpriseTeam team)

例:

team = await enterprise.CreateTeam(new EnterpriseTeam
                            {
                                Name = "Google",
                                RestrictEdit = false,
                                RestrictSharing = true,
                                RestrictView = false,
                            });

PowerCommander

コマンド: New-KeeperEnterpriseTeam

構文:

New-KeeperEnterpriseTeam [-TeamName] <string> [[-ParentNode] <long>] [[-RestrictEdit] <bool>] 
    [[-RestrictShare] <bool>] [[-RestrictView] <bool>] [<CommonParameters>]

パラメーター:

• -TeamName - チーム名 (必須)

• -ParentNode - 親ノード名またはノードID

• -RestrictEdit - 編集を制限する

• -RestrictShare - 共有を制限する

• -RestrictView - パスワード表示を制限する

例:

New-KeeperEnterpriseTeam -TeamName "Backend Team"
New-KeeperEnterpriseTeam -TeamName "Support" -ParentNode 12345 -RestrictView $true

Python CLI

コマンド: enterprise-team add

パラメーター:

team - チーム名またはキュー済みチームUID。繰り返し指定可。(必須)

フラグ:

• -f, --force - 確認プロンプトを表示しない

• --parent - 親ノード名またはID

• --restrict-edit - レコード編集を無効にする: on または off

• --restrict-share - レコード再共有を無効にする: on または off

• --restrict-view - パスワードの表示/コピーを無効にする: on または off

Python SDK

関数:

from keepersdk.enterprise import batch_management,  enterprise_management

team_names = ['追加するチーム名']
batch = batch_management.BatchManagement(loader=enterprise_loader, logger=enterprise_manager_logger)
teams_to_add = [enterprise_management.TeamEdit(
    team_uid=utils.generate_uid(), name=x, node_id=parent_id,
    restrict_edit=restrict_edit, restrict_share=restrict_share, restrict_view=restrict_view)
    for x in team_names]
batch.modify_teams(to_add=teams_to_add)
batch.apply()

チームの編集

エンタープライズチームを編集します。

DotNet CLI

コマンド:

enterprise-team update [team] [--options] または et update [team] [--options]

パラメーター:

team チーム名

オプション:

• --node <node> - ノード名またはID (追加/更新時)

• --restrict-edit <ON|OFF> - レコード編集を無効/有効にする

• --restrict-share <ON|OFF> - レコード再共有を無効/有効にする

• --restrict-view <ON|OFF> - パスワードの表示/コピーを無効/有効にする

例:

# Update team
enterprise-team update "Developers" --restrict-edit ON
et update TeamUID123 --restrict-share OFF --restrict-view ON

DotNet SDK

メソッド: UpdateTeam

public async Task<EnterpriseTeam> UpdateTeam(EnterpriseTeam team)

例:

await context.EnterpriseData.UpdateTeam(team);

PowerCommander

未実装

Python CLI

コマンド: enterprise-team edit

パラメーター:

team - チーム名またはUID。繰り返し指定可。(必須)

フラグ:

• -f, --force - 確認プロンプトを表示しない

• --name, --displayname - チーム表示名を設定する

• --parent - 親ノード名またはID

• --restrict-edit - レコード編集を無効にする: on または off

• --restrict-share - レコード再共有を無効にする: on または off

• --restrict-view - パスワードの表示/コピーを無効にする: on または off

Python SDK

関数:

from keepersdk.enterprise import batch_management,  enterprise_management

team_names = ['編集対象のチーム名']
batch = batch_management.BatchManagement(loader=enterprise_loader, logger=enterprise_manager_logger)

team_names_to_edit = {}
team_lookup: Dict[str, Union[enterprise_types.Team, List[enterprise_types.Team]]] = {}
for team in enterprise_data.teams.get_all_entities():
    team_lookup[team.team_uid] = team
    team_name = team.name.lower()
    t = team_lookup.get(team_name)
    if t is None:
        team_lookup[team_name] = team
    elif isinstance(t, list):
        t.append(team)
    elif isinstance(t, enterprise_types.Team):
        team_lookup[team_name] = [t, team]

found_teams: Dict[str, enterprise_types.Team] = {}
t: Optional[enterprise_types.Team]
for team_name in team_names_to_edit:
    t = None
    if isinstance(team_name, str):
        t = enterprise_data.teams.get_entity(team_name)
        if t is None:
            tt = team_lookup.get(team_name.lower())
            if isinstance(tt, list):
                if len(tt) == 1:
                    t = tt[0]
                elif len(tt) >= 2:
                    continue
            elif isinstance(tt, enterprise_types.Team):
                t = tt
    if t is None:
        continue
    found_teams[t.team_uid] = t
team_list = list(found_teams.values())

teams_to_edit = [enterprise_management.TeamEdit(
    team_uid=x.team_uid, name=team_name, node_id=parent_id,
    restrict_edit=restrict_edit, restrict_share=restrict_share, restrict_view=restrict_view)
    for x in team_list]
batch.modify_teams(to_update=teams_to_edit)
batch.apply()

チームの削除

エンタープライズチームを削除します。

DotNet CLI

コマンド: enterprise-team delete teamID

enterprise-team delete [team] OR et delete [team]

パラメーター:

team チーム名またはチームID

例:

# Delete team
enterprise-team delete "Old Team"
et delete TeamUID123

DotNet SDK

メソッド: DeleteTeam

 public async Task DeleteTeam(string teamUid)

例:

await context.EnterpriseData.DeleteTeam(team.Uid);

PowerCommander

未実装

Python CLI

コマンド: enterprise-team delete

パラメーター:

• team - チーム名またはUID。繰り返し指定可。(必須)

Python SDK

関数:

from keepersdk.enterprise import batch_management,  enterprise_management

team_names = ['削除するチーム名']
batch = batch_management.BatchManagement(loader=enterprise_loader, logger=enterprise_manager_logger)

team_names_to_remove = {}
team_lookup: Dict[str, Union[enterprise_types.Team, List[enterprise_types.Team]]] = {}
for team in enterprise_data.teams.get_all_entities():
    team_lookup[team.team_uid] = team
    team_name = team.name.lower()
    t = team_lookup.get(team_name)
    if t is None:
        team_lookup[team_name] = team
    elif isinstance(t, list):
        t.append(team)
    elif isinstance(t, enterprise_types.Team):
        team_lookup[team_name] = [t, team]

found_teams: Dict[str, enterprise_types.Team] = {}
t: Optional[enterprise_types.Team]
for team_name in team_names_to_remove:
    t = None
    if isinstance(team_name, str):
        t = enterprise_data.teams.get_entity(team_name)
        if t is None:
            tt = team_lookup.get(team_name.lower())
            if isinstance(tt, list):
                if len(tt) == 1:
                    t = tt[0]
                elif len(tt) >= 2:
                    continue
            elif isinstance(tt, enterprise_types.Team):
                t = tt
    if t is None:
        continue
    found_teams[t.team_uid] = t
team_list = list(found_teams.values())
batch.modify_teams(to_remove=(enterprise_management.TeamEdit(team_uid=x.team_uid) for x in team_list))
batch.apply()

メンバーシップの管理

エンタープライズチームのメンバーシップを管理します。

DotNet CLI

未実装

DotNet SDK

メソッド:

AddUsersToTeams - 指定したチームにユーザーを追加する。

RemoveUsersFromTeams - チームからユーザーを削除する。

例:

public async Task AddUsersToTeams(string[] emails, string[] teams, Action<string> warnings = null)
public async Task RemoveUsersFromTeams(string[] emails, string[] teamUids, Action<string> warnings = null)

await enterprise.AddUsersToTeams(
                            new[] { "[email protected]", "[email protected]" },
                            new[] { team.Uid }
                            );
 

PowerCommander

コマンド:

Add-KeeperEnterpriseTeamMember - 指定したチームにユーザーを追加する。

Remove-KeeperEnterpriseTeamMember - チームからユーザーを削除する。

構文:

PS> Add-KeeperEnterpriseTeamMember [-Team] <string> [-Emails] <string[]> [<CommonParameters>]
PS> Remove-KeeperEnterpriseTeamMember [-Team] <string> [-Emails] <string[]> [<CommonParameters>]

エイリアス: keta, ketu

パラメーター:

• -Team - チームUIDまたは名前

• -Emails - ユーザーのメールアドレス

例:

# チームにユーザーを追加
PS> Add-KeeperEnterpriseTeamMember -Team "Developers" -Emails"[email protected]", "[email protected]"
PS> keta "TeamUID" "[email protected]"

# チームからユーザーを削除
PS> Remove-KeeperEnterpriseTeamMember -Team "Developers" -Emails"[email protected]"
PS> ketu "TeamUID" "[email protected]", "[email protected]"

Python CLI

コマンド: enterprise-team membership

パラメーター:

team - チーム名またはUID。繰り返し指定可。(必須)

フラグ:

• -au, --add-user - チームにユーザーを追加する。繰り返し指定可。

• -ru, --remove-user - チームからユーザーを削除する。@all。繰り返し指定可。

• -ar, --add-role - チームにロールを追加する。繰り返し指定可。

• -rr, --remove-role - チームからロールを削除する。@all。繰り返し指定可。

Python SDK

関数:

from keepersdk.enterprise import batch_management,  enterprise_management

team_names = ['チームのUIDまたは名前']
batch = batch_management.BatchManagement(loader=enterprise_loader, logger=enterprise_manager_logger)

team_names_to_remove = {}
team_lookup: Dict[str, Union[enterprise_types.Team, List[enterprise_types.Team]]] = {}
for team in enterprise_data.teams.get_all_entities():
    team_lookup[team.team_uid] = team
    team_name = team.name.lower()
    t = team_lookup.get(team_name)
    if t is None:
        team_lookup[team_name] = team
    elif isinstance(t, list):
        t.append(team)
    elif isinstance(t, enterprise_types.Team):
        team_lookup[team_name] = [t, team]

found_teams: Dict[str, enterprise_types.Team] = {}
t: Optional[enterprise_types.Team]
for team_name in team_names_to_remove:
    t = None
    if isinstance(team_name, str):
        t = enterprise_data.teams.get_entity(team_name)
        if t is None:
            tt = team_lookup.get(team_name.lower())
            if isinstance(tt, list):
                if len(tt) == 1:
                    t = tt[0]
                elif len(tt) >= 2:
                    continue
            elif isinstance(tt, enterprise_types.Team):
                t = tt
    if t is None:
        continue
    found_teams[t.team_uid] = t
team_list = list(found_teams.values())

users_to_add: Optional[List[enterprise_types.User]] = None
roles_to_add: Optional[List[enterprise_types.Role]] = None
users_to_remove: Optional[List[enterprise_types.User]] = None
roles_to_remove: Optional[List[enterprise_types.Role]] = None
has_remove_all_users: bool = False
has_remove_all_roles: bool = False

add_users = ['追加するユーザー名のリスト']
if isinstance(add_users, list):
    for add_user in add_users:
        user = [user for user in enterprise_data.users.get_all_entities() if user.username.lower() == add_user.lower()]
        users_to_add.append(user)

add_roles = ['追加するロールのリスト']
if isinstance(add_roles, list):
    for role_name in add_roles:
        if isinstance(role_name, int):
            role = enterprise_data.roles.get_entity(role_name)
        elif isinstance(role_name, str):
            if role_name.isnumeric():
                role = enterprise_data.roles.get_entity(int(role_name))
            if not role:
                role = [x for x in enterprise_data.roles.get_all_entities() if x.name.lower() == role_name.lower()]
    roles_to_add.append(role)

remove_users = ['削除するユーザー名のリスト']
if isinstance(remove_users, list):
    has_remove_all_users = any((True for x in remove_users if x == '@all'))
    if not has_remove_all_users:
        for remove_user in remove_users:
            user = [user for user in enterprise_data.users.get_all_entities() if user.username.lower() == remove_user.lower()]
            users_to_remove.append(user)

remove_roles = ['削除するロールのリスト']
if isinstance(remove_roles, list):
    has_remove_all_roles = any((True for x in remove_roles if x == '@all'))
    if not has_remove_all_roles:
        for role_name in remove_roles:
            if isinstance(role_name, int):
                role = enterprise_data.roles.get_entity(role_name)
            elif isinstance(role_name, str):
                if role_name.isnumeric():
                    role = enterprise_data.roles.get_entity(int(role_name))
                if not role:
                    role = [x for x in enterprise_data.roles.get_all_entities() if x.name.lower() == role_name.lower()]
        roles_to_remove.append(role)

for team in team_list:
    existing_users = {x.enterprise_user_id for x in enterprise_data.team_users.get_links_by_subject(team.team_uid)}
    existing_roles = {x.role_id for x in enterprise_data.role_teams.get_links_by_object(team.team_uid)}
    if users_to_add:
        users_to_add = [x for x in users_to_add if x.enterprise_user_id not in existing_users]
        if users_to_add:
            batch.modify_team_users(to_add=[enterprise_management.TeamUserEdit(
                team_uid=team.team_uid, enterprise_user_id=x.enterprise_user_id) for x in users_to_add])
    if roles_to_add:
        roles_to_add = [x for x in roles_to_add if x.role_id not in existing_roles]
        if roles_to_add:
            batch.modify_role_teams(to_add=[enterprise_management.RoleTeamEdit(
                role_id=x.role_id, team_uid=team.team_uid) for x in roles_to_add])
    if has_remove_all_users:
        batch.modify_team_users(to_remove=[enterprise_management.TeamUserEdit(
            team_uid=team.team_uid, enterprise_user_id=x) for x in existing_users])
    elif users_to_remove:
        batch.modify_team_users(to_remove=[enterprise_management.TeamUserEdit(
            team_uid=team.team_uid, enterprise_user_id=x.enterprise_user_id) for x in users_to_remove])
    if has_remove_all_roles:
        batch.modify_role_teams(to_remove=[enterprise_management.RoleTeamEdit(
            role_id=x, team_uid=team.team_uid) for x in existing_roles])
    elif roles_to_remove:
        batch.modify_role_teams(to_remove=[enterprise_management.RoleTeamEdit(
            role_id=x.role_id, team_uid=team.team_uid) for x in roles_to_remove])

batch.apply()