Interfaces Reference
Nortel Application Server Application Programming
NN42040-110
Nortel AS
Document release date 11 June Copyright 2008 Nortel Networks
Nortel AS Release Publication NN42040-110 Document status Standard
All Rights Reserved Sourced in Canada LEGAL NOTICE
All other trademarks are the property of their respective owners
Using the Bulk Provisioning Tool
Contents
Using the Open Provisioning Interface
New in this release
Starting the Bulk Provisioning Tool
Accessing the OPI Java docs
Creating Open Provisioning Interface clients
Importing a CA Certificate into the BPT
Other changes
New in this release
Revision history
Nortel AS
Nortel AS
6 New in this release
NN42040-110 01.01 Standard 11 June
Copyright 2008 Nortel Networks
Using the Open Provisioning Interface page
Using the Bulk Provisioning Tool page
Accessing the OPI Java docs page
Introduction
Nortel AS
8 Introduction
NN42040-110 01.01 Standard 11 June
Copyright 2008 Nortel Networks
Open Provisioning Interface fundamentals
Application Programming Interface fundamentals
Open Provisioning Interface fundamentals page
Bulk Provisioning Tool fundamentals page
Bulk Provisioning Tool fundamentals
Why use the Bulk Provisioning Tool
Bulk Provisioning Tool requirements
Nortel AS
12 Application Programming Interface fundamentals
NN42040-110 01.01 Standard 11 June
Copyright 2008 Nortel Networks
Install and launch the BPT
Using the Bulk Provisioning Tool
Install and launch the BPT page BPT main menu page
BPT main menu
BPT main menu
14 Using the Bulk Provisioning Tool
Accessing the Domain Operations submenu
Command
BPT main menu commands
method name using * into
Description
BPT files and scripts
BPT provisioning methods
Navigation
Files
Success indication on remove methods page Unknown error messages page
Create and manage provisioning roles using the BPT page
BPT conventions and examples
Scripts
Optional syntax
getRole using Role name file file name optional into file name
Brackets
Angle brackets
getRole using Role name file file name optional into file name
Square brackets
Admin,,English,Devices only,yourcompany.com
newguy,mysecret,John,Edwards,Active,,,, ,,,,,Default
Comma separated strings
Fully qualified user name
Create and manage provisioning roles using the BPT
Unknown error messages
Define the new provisioning role
Define the new provisioning role page
getRole using AddExample
addRole using file D\prov\addexample.txt
Add the new provisioning role
View the new provisioning role
getRole method invoked in the BPT
Delete the new provisioning role
help addRole
BPT Help option
BPT mapping to the Provisioning Client
BPT limitations
BPT mapping to the Provisioning Client page Batch processing page
Resource use page Provisioning data visibility page
Bulk provisioning of users
Batch processing
Resource use
Provisioning data visibility
Nortel AS
28 Using the Bulk Provisioning Tool
NN42040-110 01.01 Standard 11 June
Copyright 2008 Nortel Networks
Security, authentication, and authorization
Using the Open Provisioning Interface
Security, authentication, and authorization page
Security page Authentication page Authorization page
HTTP Basic Authentication - Onboard Authentication
Authentication
HTTP Basic Authentication - Onboard Authentication page
WS-Security UsernameToken
Sample WS-Security header/SOAP message
A special note for .NET authentication headers
Domain-level authorization
Authorization
Provisioning-level authorization
Domain-level authorization page Provisioning-level authorization page
Access stubs from the third-party application page
Implement interface accessing stubs page
Third-party client development
Get the WSDL
Access stubs from the third-party application
Implement interface accessing stubs
Starting the Bulk Provisioning Tool
Starting the Bulk Provisioning Tool
Downloading the Bulk Provisioning Tool to a workstation
Procedure Steps
Launching the BPT on a workstation
Downloading the Bulk Provisioning Tool to a workstation page
The BPT application launches
2 Enter your administrator username and password
Launching the BPT on a workstation
Nortel AS
Nortel AS
38 Starting the Bulk Provisioning Tool
NN42040-110 01.01 Standard 11 June
Copyright 2008 Nortel Networks
Creating OPI clients
Creating Open Provisioning Interface clients
Prerequisites for creating OPI clients
Configuring the class path page Downloading the WSDL file page
Downloading the Axis toolkit page Retrieving the error codes page
Compiling the client stubs page
Writing a client to perform some specific OPI operations page
Downloading the Axis toolkit
Retrieving the error codes
Configuring the class path
D\axis-14\webapps\axis\WEB-INF\lib
Compiling the client stubs
Downloading the WSDL file
D\opiclient
loadname/wsdl/opi
Writing a client to perform some specific OPI operations
t\opi\service
Procedure Steps
Step Action
Example - Writing a client
The client class can be compiled similarly to the compilation of the OPI Stubs, and executed. The OPI Stub classes and AXIS toolkit jars must be present in the classpath during execution, as demonstrated in the following figure
Compiling the client class
46 Creating Open Provisioning Interface clients
Nortel AS
NN42040-110 01.01 Standard 11 June
Step Action
Accessing the OPI Java docs
Procedure Steps
OPIJavadocs file unzipped
AdminAuthentication subfolder in the OPI Java Docs folder
Accessing the javadocs for the AdminAuthentication OPI web service
Nortel AS
50 Accessing the OPI Java docs
NN42040-110 01.01 Standard 11 June
Copyright 2008 Nortel Networks
The tool prompts Trust this certificate? no
Importing a CA Certificate into the BPT
keytool -list -v -keystore opitruststore
Procedure Steps
Nortel AS
52 Importing a CA Certificate into the BPT
NN42040-110 01.01 Standard 11 June
Copyright 2008 Nortel Networks
Page
Nortel AS