Blackberry SWD-504685-0330050601-001 manual Syntax for authentication credentials

Page 15

Administration Guide

Compatibility of authentication methods with previous versions of the BlackBerry Enterprise Server User Administration Tool

Syntax for authentication credentials

In the BlackBerry® Enterprise Server User Administration Tool BlackBerry Enterprise Server User Administration Tool, the variable <credentials> represents the user name and password that you use for authentication with the BlackBerry Administration Service.

The BlackBerry Enterprise Server User Administration Tool uses the following syntax for authentication credentials.

Item

Description

 

 

-username <user name>

authentication user name

-sqluser <user name>

 

-password <password>

authentication password

-sqlpass <password>

 

-domain <domain>

authentication domain

-bas_auth

use BlackBerry Administration Service authentication (default)

-mailbox_auth

use mailbox authentication (IBM® Lotus® Domino® environment only)

-ad_auth

use Microsoft® Active Directory® authentication

 

 

In the BlackBerry Enterprise Server User Administration Tool, the variable <credentials> represents the user name and password that you use for authentication with the BlackBerry Administration Service.

Setting authentication credentials

Storing an encrypted set of authentication credentials in the Windows registry

The BlackBerry® Enterprise Server User Administration Tool uses the -set_client_auth <credentials> -set_p <password> command to store credentials in the Windows® registry and then insert the credentials into the command line options.

Example

BESUserAdminClient -username admin -password password -set_client_auth "-username smoser -password password1 - ad_auth -domain test.rim.net" -set_p password

This creates the following Windows registry entry:

HKEY_LOCAL_MACHINE\SOFTWARE\Research In Motion\BlackBerry Resource Kit\BESUserAdmin\ClientAuth

13

Image 15
Contents Administration Guide SWD-504685-0330050601-001 Contents Sending notification messages to BlackBerry devices Input, output, and user feedback parameters Setuseritpolicyrule BlackBerry Enterprise Server User Administration Tool OverviewEdit a group across Group Create a software Configuration View a software Delete a software Configuration Create an applicationTemplate View a job Service View pull rules for Service instance View push rules forNew in this release Add and remove a role across organizationsTool Description BlackBerry Enterprise Activation Password InputfilenameOutputfilename Servername Authentication credentials Supported authentication modelsSyntax for authentication credentials Example User name SQLU1 Password SQLP1String value requirements Use casesBASP1 -basauth -setp password1 Following command BESUserAdminClientSetclientauth -basauth -setp password1 Setclientauth -username BASU1 -passwordRe-install the service using the new client password Username Managing user accountsAdding user accounts Add a new user account to the BlackBerry Enterprise ServerAdd an existing user account to a group Assign a software configuration to a user accountUsername Sw configurationname Add a new user account to a groupFinding user accounts Changing and removing user accountsFind a user account Username Instance Delete a software configuration from a user accountMove a user account to a different user group Delete a user account from a groupDelete a user account from the BlackBerry Enterprise Server Change user account settingsList the groups in a BlackBerry Domain Turn on or turn off email message forwarding Managing email message forwardingTurn on or turn off email message forwarding for folders List the IT policy rules in an IT policy Managing IT policies and IT policy rulesSet IT policy rules for a user account Set a password for a BlackBerry device Managing BlackBerry devicesSet owner information on a BlackBerry device Delete pending messages Resend a service bookProtect a stolen BlackBerry device Resend the peer-to-peer encryption keySubject subjectlinetext Body messagebodytext Send a notification PIN messageUsername or Groupname Instance Infofile filename orSend a notification email message Results of a statistics query for a user account BlackBerry devicesRetrieving user account statistics and information about Retrieve user account statisticsDevice Type Model number of the BlackBerry device State Column Description ServerDNThat is associated with the BlackBerry device PIN of the BlackBerry deviceRetrieve enterprise activation statistics for a user account Clear user account statisticsRetrieve enterprise activation statistics for a user account Retrieve the statistics for BlackBerry devices Retrieving BlackBerry device informationHome Carrier Results of a statistics query for a BlackBerry deviceUsers userdeviceinformation Groupname Instance Column Description User Name Name of the user accountSystem Status Software configuration on the deviceUptime Time since the BlackBerry device was last reset Column Description IT Policy TimeMessaging server Instance sent Enterprise Server instanceInstance filtered Yyyymmdd is the date Administration ToolTroubleshooting the BlackBerry Enterprise Server User Configuring log filesWarn Error Fatal Using the command summary in the help file Common parameters BES1,USER7,GROUP2,true Input, output, and user feedback parametersSubparameter Description BES1,USER2,GROUP1,falseWell as messages of earlier levels With the BlackBerry Administration ServiceError This level is not currently used Be one of the following typesBlackBerry Administration Service AddGroupWise Ory Itpolicy ITpolicynameWt expiry time Cannot use this subparameter with -sw AssignswconfigSubparameters -assignswconfig Description Csw configurationnameUtype type Syntax -change ChangeAccount This subparameter clears the users email message filtersBlackBerry Enterprise Server for Novell GroupWise Enterprise Server for Novell GroupWiseAccount to -add or an existing user account to -change PurgependingmessagesFrom Subparameter Description Canonicalname PasswordForce Administration Tool does not find the mailboxDelete Subparameters -delete DescriptionAdministration Guide Subparameters -find Description FindHandheldinfo Hhstats Subparameters -handheldinfo Description AppnameWork with the -u or -b subparameters Action. It works with the -u subparameterInstead of one user account Subparameter Description UsersSubparameters -killhandheld Description KillhandheldAdministration Guide List Configurationname Apppolicyname InstanceItpolicy IT policyname Displayname Move Subparameters -move DescriptionMove the account to Administration Guide Resendpeertopeerkey Subparameters -resendpeertopeerkey DescriptionAction Subparameters -resendservicebook Description ResendservicebookSendemail Body bodytextInfofile filename.txt Utype type This subparameter specifies the name of the user group SendpinSubparameters -sendpin Description This subparameter specifies the body of the PIN messageDisplayname Setclientauth Default authentication typeSqluser username Interchangeably with -passwordExchange messaging server Credentials in the Windows registryFoldername foldername SetfolderredirectionSubparameters -setfolderredirection Description Server for Novell GroupWiseUsername Infofile infofile.txt SetownerinfoSubparameters -setownerinfo Description Info ownerinformationUtype type Subparameters -setpassword Description SetpasswordSetuseritpolicyrule Subparameters -setuseritpolicyrule DescriptionPolicyrule policyrulename Administration Guide Email emailinstance Service This subparameter specifies service instancesStats Subparameters -stats DescriptionUtype type Status Glossary Provide feedback Legal notice Administration Guide Administration Guide