内容

概要

背景説明

前提条件

要件

使用するコンポーネント

BroadWorks Administrator

設定

確認

システム管理者

設定

確認

リセラー/エンタープライズ/サービスプロバイダー/グループ管理者

設定

確認

CLIコマンドを使用した管理者アカウントの追加

概要

このドキュメントでは、BroadWorks Application Server(AS)のさまざまな種類の管理者アカウントと、新しいアカウントを作成する手順について説明します。

背景説明

Cisco BroadWorksはLinux OS上にインストールされるアプリケーションで、複数のインターフェイスからアクセスできます。したがって、複数の異なる管理者アカウントが用意されています。

- ルートユーザ：OSのインストール中に作成されたアカウント。システムへのフルアクセスを提供するため、注意して使用する必要があります。これは、この記事の範囲外です。ルートアクセスを管理し、セキュアに保つためには、OSベンダーのガイドラインを適用する必要があります。たとえば、BroadWorksがRed Hat Enterprise Linux(RHEL)上にインストールされている場合は、Red Hatのスーパーユーザアクセスに関するドキュメントを参照できます。

- BroadWorks管理者（bwadminとも呼ばれる）:BroadWorksアプリケーションを管理し、コマンドラインインターフェイス(CLI)経由でアクセスするために使用するアカウント。

- システム管理者 – Webインターフェイスを介してBroadWorksアプリケーションにログインするために使用されるアカウント。

- リセラー/エンタープライズ/サービスプロバイダー/グループ管理者：特定のリセラー/エンタープライズ/サービスプロバイダー/グループの管理に使用するアカウント。

前提条件

要件

次の項目に関する知識があることが推奨されます。

- 基本的なBroadWorks管理。

- 基本的なLinuxコマンド。

使用するコンポーネント

このドキュメントの情報は、BroadWorks ASバージョンR24に基づくものです。

このドキュメントの情報は、特定のラボ環境にあるデバイスに基づいて作成されました。このドキュメントで使用するすべてのデバイスは、初期（デフォルト）設定の状態から起動しています。本稼働中のネットワークでは、各コマンドによって起こる可能性がある影響を十分確認してください。

BroadWorks Administrator

設定

最初のBroadWorks管理者アカウントは、BroadWorksのインストール時に作成されます。追加のアカウントを作成するには、次の手順を使用します。

ステップ 1：ルートクレデンシャルを使用してBroadWorks CLIにログインします。

ステップ 2：/usr/local/broadworks/bw_base/sbinディレクトリに移動します。

[root@as1 ~]# cd /usr/local/broadworks/bw_base/sbin

ステップ 3：bwuseradd -hコマンドを実行して、設定オプションをリストします。

[root@as1 sbin]# ./bwuseradd –h

Missing argument: role

bwuseradd Version 1.14

USAGE: bwuseradd

<-r, --role BWORKS|BWSUPERADMIN|OPERATOR|VIEWER> [-p, --passwd password] [-d, --default] [-c, --centralized] [-v, --verbose] [-h, --help] Parameters:

: the new user name -r, --role : the user assigned role -p, --passwd : the user password. Enclose the password in single quotes if it contains special characters. -d, --default : reset passwd -c, --centralized : for centralized user management -v, --verbose : run in verbose mode -h, --help : print this Help Description: Invokes Unix/ldap commands to create a local/centralized bw user Example: bwuseradd -r OPERATOR --passwd admin123 admin

新しいアカウントを作成するときは、次の4つのロールのいずれかを選択する必要があります。

- BWSUPERADMIN：このロールには、インストールファイルのルートアクセス権があります。このロールは、Cisco BroadWorksのインストールとアップグレードに使用されます。

- BWORKS：このロールは、Cisco BroadWorksサーバで使用できるCLIまたはその他のツールを使用して、開始、停止、および変更を行うことができます。

- オペレータ：このロールはCisco BroadWorksコンフィギュレーションファイルを設定できますが、Cisco BroadWorksの起動や停止はできません。

- VIEWER：このロールは現在の設定を表示できますが、変更を実行できません。

このセクションで使用されるコマンドの詳細については、『UNIXユーザアカウント設定ガイド』を参照してください。

ステップ 4：bwuseraddコマンドを実行して、新しいユーザを作成します。

[root@as1 sbin]# ./bwuseradd -r BWORKS --passwd bwadmin1 bwadmin1

Changing password for user bwadmin1.

passwd: all authentication tokens updated successfully.

User will be required to change password upon next login

Expiring password for user bwadmin1.

passwd: Success

WARNING: Please make sure this user is created on all servers.

WARNING: Do not forget to run 'config-ssh -createKeys

' for the new user.

ステップ 5：ASがクラスタモードでインストールされている場合は、セカンダリノードで同じコマンドを実行します。

[root@as2 sbin]# ./bwuseradd -r BWORKS --passwd bwadmin1 bwadmin1

Changing password for user bwadmin1.

passwd: all authentication tokens updated successfully.

User will be required to change password upon next login

Expiring password for user bwadmin1.

passwd: Success

WARNING: Please make sure this user is created on all servers.

WARNING: Do not forget to run 'config-ssh -createKeys

' for the new user.

手順 6：新しいユーザとしてログインします。パスワードのリセットを求めるプロンプトが表示されます。

bwadmin1@as1's password:

You are required to change your password immediately (administrator enforced)

WARNING: Your password has expired.

You must change your password now and login again!

Changing password for user bwadmin1.

Current password:

New password:

Retype new password:

手順 7：binコマンドを実行して、プライマリASの/usr/local/broadworks/bw_base/binに移動します。

bwadmin1@as1.mleus.lab$ bin

bwadmin1@as1.mleus.lab$ pwd

/usr/local/broadworks/bw_base/bin

ステップ 8：config-sshコマンドを実行して、共通キーペアを作成します。

bwadmin1@as1.mleus.lab$ ./config-ssh -createKeys bwadmin1@as2

==============================================

==== SSH CONFIGURATION TOOL version 2.2.22  ====

=> Setting default settings <=

Setting 'StrictHostKeyChecking no'

Setting 'ServerAliveInterval 250'

=> DNS Sanity test <=

[###############]

[...............]

Configured: y, Reachable: y, Resolved: y, Required: n.

Using bwadmin1@as1.mleus.lab as local peer name for as1.mleus.lab.

=> DNS OK <=

=> Peer reachability test <=

[###]

[...]

=> Creating SSH keys <=

Creating keys for bwadmin1@as2...

bwadmin1@as2's password:

Generating ecdsa key...

Generating rsa key...

Creating keys for bwadmin1@as1.mleus.lab...

bwadmin1@as1.mleus.lab's password:

Generating ecdsa key...

Generating rsa key...

=> Keying SSH <=

Preparing bwadmin1@as1.mleus.lab for keying...

Cleaning public keys for bwadmin1@as2...

Sharing keys with bwadmin1@as2...

Pushing local public keys...

bwadmin1@as2's password:

Pulling remote public keys...

bwadmin1@as2's password:

Sharing keys with bwadmin1@as2... [done]

=> Fully meshing SSH peers <=

=> Recursing with bwadmin1@as2 <=

Pushing config-ssh script to bwadmin1@as2...

Launching config-ssh on bwadmin1@as2...

=> Setting default settings <=

Adding 'StrictHostKeyChecking no'

Adding 'ServerAliveInterval 250'

=> DNS Sanity test <=

[###############]

[...............]

Configured: y, Reachable: y, Resolved: y, Required: n.

Using bwadmin1@as2.mleus.lab as local peer name for as2.mleus.lab.

=> DNS OK <=

=> Peer reachability test <=

[###]

[...]

=> Keying SSH <=

Preparing bwadmin1@as2.mleus.lab for keying...

Cleaning public keys for bwadmin1@as1.mleus.lab...

Sharing keys with bwadmin1@as1.mleus.lab...

Pushing local public keys...

Pulling remote public keys...

Sharing keys with bwadmin1@as1.mleus.lab... [done]

=> Testing ssh configuration <=

Testing bwadmin1@as2... [done]

==== SSH CONFIGURATION TOOL completed ====

確認

新しいユーザを確認するには、新しいクレデンシャルでCLIにログインし、基本的なBroadWorksコマンドをいくつか実行します。

bwadmin1@as1.mleus.lab$ bwshowver

AS version Rel_24.0_1.944

Built  Sat Jun  6 00:26:50 EDT 2020

- BASE revision 909962

- AS revision 909962

Patching Info:

Active Patches: 701

bwadmin1@as1.mleus.lab$ bwcli

======================================================================

BroadWorks Command Line Interface

Type HELP for more information

======================================================================

AS_CLI>

システム管理者

設定

ステップ 1：https://<AS_FQDN>/Loginページに移動し、AS Webインターフェイスにログインします。

ステップ 2：[System] > [Profile] > [Administrators] に移動します。

ステップ 3：Addボタンをクリックします。

ステップ 4：すべてのフィールドに値を入力します。

選択する管理者には、次の2つのタイプがあります。

- システムは、管理者にシステムへのフルアクセスを提供します。

- Provisioningを使用すると、管理者は新しい顧客を追加したり、顧客アカウントを管理したりするために、システムへのアクセスを制限できます。

ステップ 5：[OK] をクリックして変更を保存します。

確認

[System] > [Profile] > [Administrators] に移動し、新しく作成されたアカウントを検索します。

ログアウトし、新しいクレデンシャルのセットを使用して再度ログインします（パスワードの変更を求められます）。

メニューをナビゲートして、必要なオプションがすべて使用可能であることを確認します。

また、CLIを使用して新しいクレデンシャルを確認することもできます。BroadWorks CLI(BWCLI)を開き、新しいクレデンシャルのセットを使用してloginコマンドを実行します。

AS_CLI> login webadmin

Password:

webadmin logging in...

リセラー/エンタープライズ/サービスプロバイダー/グループ管理者

設定

ステップ 1：https://<AS_FQDN>/Loginページに移動し、AS Webインターフェイスにログインします。

ステップ 2：[System] > [Profile] に移動し、さらに管理者を作成する[Reseller] 、[Enterprises]、[Service Providers]、または[Group]に移動します。この設定例ではサービスプロバイダーを使用していますが、他のエンティティの設定は同じです。

ステップ 3：新しい管理者を追加するサービスプロバイダーを選択します。

ステップ 4：[Profile] > [Administrators] に移動し、[Add] ボタンをクリックします。

ステップ 5：すべてのフィールドに値を入力します。

サービスプロバイダー/エンタープライズ用に選択する管理者には、次の3つのタイプがあります（リセラーおよびグループ用には、タイプの選択はありません）。

- サービスプロバイダーは通常の管理者を作成し、[Administrator Policies] ページで設定したポリシーによって決定されるWebインターフェイスにアクセスできるようにします。

- 顧客が顧客管理者を作成します。 顧客管理者は、サービスプロバイダーの[Groups] 、[Users] 、[Service Instances] 、および[Change Password] ページにのみアクセスできます。 顧客管理者は、すべてのグループのグループページにアクセスできます。ただし、[Intercept Group] ページへの読み取り専用アクセス権と[Call Capacity] ページへのアクセス権はありません。 [Administrator Policies] ページで設定したポリシーを使用して、顧客管理者のアクセスをさらに制限できます。

- [パスワードのリセットのみ(Password Reset Only)]を選択すると、管理者はユーザパスワードのみを変更できます。管理者は、Webインターフェイス内の他のページ、データ、またはコマンドにアクセスできません。

手順 6：[OK] をクリックして変更を保存します。

確認

[System] > [Profile] > [Service Providers] または[Enterprises] に移動し、管理者アカウントを作成したエンティティを選択します。次に、[Profile] > [Administrators] に移動し、新しく作成された管理者を検索します。

ログアウトし、新しいクレデンシャルのセットを使用して再度ログインします（パスワードの変更を求められます）。

メニューをナビゲートして、特定のサービスプロバイダー/エンタープライズに関連する設定のみが表示されていることを確認します。

CLIコマンドを使用した管理者アカウントの追加

すべてのWebアクセスアカウントは、BWCLIコマンドから作成することもできます。これについては、このドキュメントでは詳しく説明しませんが、次の各コマンドを参照してください。

- システム管理者：

AS_CLI/SubscriberMgmt/Administrator> h add

When adding a new administrator to the system, you set the administrator user

ID, access level, first and last names, and password.

Parameters description:

userId   : The user ID for the administrator.

type     : when set to "system", allows for complete access to the Application

Server CLI and its functions.

When set to "prov", allows only limited access to the Application

Server CLI, specifically functions in the network level only.

readOnly : Cannot configure the system.

attribute: Additional attributes to include through the add command.

lastName : The user's last name.

firstName: The user's first name.

language : Indicates the language to be used for the administrator.

======================================================================

add

, String {2 to 80 characters}

, Choice = {system, prov}

, Choice = {false, true} [

, Multiple Choice = {lastName, firstName, language}]

, String {1 to 30 characters}

, String {1 to 30 characters}

, String {1 to 40 characters}

- リセラー管理者：

AS_CLI/SubscriberMgmt/Reseller/Administrator> h add

This command is used to add a new reseller administrator. When this command is

used, you are prompted for password information.

Parameters description:

resellerId: The ID of the reseller.

userId    : The user ID for the reseller administrator.

attribute : Additional attributes to include with the name command.

lastName  : This parameter specifies the reseller administrator's last name.

firstName : This parameter specifies the reseller administrator's first name.

language  : This parameter specifies the reseller administrator's supported

language.

======================================================================

add

, String {1 to 36 characters}

, String {2 to 80 characters} [

, Multiple Choice = {lastName, firstName, language}]

, String {1 to 30 characters}

, String {1 to 30 characters}

, String {1 to 40 characters}

- エンタープライズ/サービスプロバイダー管理者：

AS_CLI/SubscriberMgmt/ServiceProvider/Administrator> h add

When adding a new service provider administrator to the system, the

corresponding service provider administrator's user ID, first name, and last

names are set. You are prompted for password information.

Parameters description:

svcProviderId: The service provider.

userId       : The user ID for the service provider administrator.

adminType    : When set to "normal", the service provider administrator has all

standard access rights and privileges.

When set to "customer", the customer administrator only has

access to the Group, User, and Change Password web portal pages.

Also, the customer administrator has no access to Call Capacity

and has read-only access to Intercept Group pages.

When set to "passwordResetOnly", this value allows the service

provider administrator to reset the user's web and portal

password only.

attribute    : Additional attributes to include through the add command.

lastName     : The service provider administrator's last name.

firstName    : The service provider administrator's first name.

language     : The service provider's supported language.

======================================================================

add

, String {1 to 30 characters}

, String {2 to 80 characters}

, Choice = {normal, customer, passwordResetOnly} [

, Multiple Choice = {lastName, firstName, language}]

, String {1 to 30 characters}

, String {1 to 30 characters}

, String {1 to 40 characters}

- グループ管理者：

AS_CLI/SubscriberMgmt/Group/Administrator> h add

When adding a new group administrator to the system, the corresponding group

name and service provider, and the group administrator's user ID, first name,

and last name are set.

Parameters description:

svcProviderId: The ID of the service provider to whom the group and group

administrator belong.

groupId      : The ID of the group to which the administrator belongs.

userId       : The user ID for the group administrator.

attribute    : Additional attributes to include through the add command.

lastName     : The group administrator's last name.

firstName    : The group administrator's first name.

language     : The supported language for the group administrator.

======================================================================

add

, String {1 to 30 characters}

, String {1 to 30 characters}

, String {2 to 161 characters} [

, Multiple Choice = {lastName, firstName, language}]

, String {1 to 30 characters}

, String {1 to 30 characters}

, String {1 to 40 characters}