Raritan Computer CC-WSAPI-0B-v5.1.0-E Manuale Utente Pagina 1

Copyright © 2011 Raritan, Inc. CC-WSAPI-0B-v5.1.0-E February 2011 255-80-0004-00 CommandCenter Secure Gateway WS-API Programming Guide Relea

6 In This Chapter Conventions ... 6 Common Data Types .

Chapter 2: API Definitions 7 System Management This set of services is for general CC-SG settings and information. http(s)://CC_IP_ADDRESS:8080/C

Chapter 2: API Definitions 8 Services getSystemInfo Retrieve information about the CC-SG.  parameters  String sessionID  return value  Sys

Chapter 2: API Definitions 9 signoff() This operations signs off (log out) a particular user from CC-SG. The application can have multiple users

Chapter 2: API Definitions 10  String applicationId - CC-SG generated string which uniquely identifies the access application type within CC-SG

Chapter 2: API Definitions 11  String deviceName i.e the name of the Raritan device. This field is filled in only for out-of-band interfaces; o

Chapter 2: API Definitions 12 URLObject Components to form a URL to access the CC-SG.  Elements  String protocol - the protocol used - either

Chapter 2: API Definitions 13 Services getCCSGAppletURL This operation retrieves the full URL to the CC-SG Admin Client applet in order to launch

Chapter 2: API Definitions 14 getAccessMethodsForNode This operation retrieves all the available access methods (applications) for a given node in

Chapter 2: API Definitions 15 getNodeByInterfaceName Retrieves nodes by the name of the interface.  parameters  String sessionID  String in

This document contains proprietary information that is protected by copyright. All rights reserved. No part of this document may be photocopied, repro

Chapter 2: API Definitions 16 addAssociationToNode Associate the node with one or more category values  parameters  String sessionID  String

Chapter 2: API Definitions 17 getNodePower Returns the power status of each interface of the node, including the status of the latest power opera

Chapter 2: API Definitions 18  power on  power off  power cycle  graceful shutdown  suspend  Integer sequenceInterval – The interval,

Chapter 2: API Definitions 19  Integer passwordExpirationPeriod – The user will have to reset their password after this many days (required if

Chapter 2: API Definitions 20 addUser Add a new user configuration to the CC-SG.  parameters  String sessionID  CCSGUser user – The new use

Chapter 2: API Definitions 21  return value  boolean true deleteUserFromGroup Remove a user from a group to control their access of the CC-S

Chapter 2: API Definitions 22  Access Audit  Access Connection  Authentication  Error  Power  Tasks  User Maintenance  String mess

Chapter 2: API Definitions 23  String message – Specific error message. Services runReport Returns a log report formed using the request para

Chapter 2: API Definitions 24  Access Audit  Access Connection  Authentication  Error  Power  Tasks  User Maintenance  String mess

Chapter 2: API Definitions 25 deleteReport Delete a previously requested report; otherwise, reports are deleted after the user session is termina

iii Contents Chapter 1 Introduction 1 Connecting to CC-SG ...

Chapter 2: API Definitions 26 addCategory Add a new category to CC-SG.  parameters  String sessionID  String name - Unique name to identify

Chapter 2: API Definitions 27 addElementToCategory Add one or more values to the specified category  parameters  String sessionID  String c

28 This appendix contains some tips on managing certificates. See the respective company's documentation for more details. In This Chapter Ja

Appendix A: Certificate Management 29 For example: https://10.0.0.101:9443/CommandCenterWebServices/AuthenticationAndAuthorizationServicePort?wsd

30 This section focuses on CC-SG specific topics regarding WS client development in Java. In This Chapter Choose a WS Library ...

Appendix B: Web Services Development in Java 31 Setting the CCSG Address Downloading the WSDL files from port 8080 of the CC-SG is the default so

Appendix B: Web Services Development in Java 32 Call the method from your application for each service object. This example uses AuthenticationAnd

Appendix B: Web Services Development in Java 33 /* * RCSfile: ... * Revision: ... * Date: ... * * This source code is owned by Raritan Compu

Appendix B: Web Services Development in Java 34 import node.service.webservice.bl.cc.raritan.com.CCSGNodeManagementService; import node.service.we

Appendix B: Web Services Development in Java 35 public static void set_service_end_point( Service service, BindingProvider port ) { Patte

Contents iv Appendix A Certificate Management 28 Java keytool ...

Appendix B: Web Services Development in Java 36 System.err.println("Could not read input."); return null; } if( nam

Appendix B: Web Services Development in Java 37 { session = port.signOn( user, password ); } catch ( security.service.webservice.bl

Appendix B: Web Services Development in Java 38 } else System.err.println( "Could not change node name without the current and

39 The following sections describe how to create a Web Services client for the CCSG written in C#. This description is based on Microsoft Visual St

Appendix C: Web Services Development in C# 40 4. Set a call back for ServerCertificateValidationCallback so that the client will accept the CCSG&

Appendix C: Web Services Development in C# 41 using System; using System.Collections.Generic; using System.Linq; using System.Text; using System.

Appendix C: Web Services Development in C# 42 Console.WriteLine("signOff Response: " + response.result);

Appendix C: Web Services Development in C# 43 new CCAuthentication.AuthenticationAndAuthorizationServiceClient(); aut

Appendix C: Web Services Development in C# 44 // renameNode service CCNode.NodeManagementServiceClient node_service = new

Appendix C: Web Services Development in C# 45 } } }

1 Web Services API uses standardized Web Services technologies to allow a client machine to perform node, power, user, and logging management servi

47 A Access Information • 4 AccessMethod • 9 Add Web Services API Client Configuration on CC-SG • 1, 2, 29 addAssociationToNode • 16 addCategory •

Index 48 S Sample Application for C# • 40 Sample Application for Java • 32 Saving the CCSG's Server Certificate from a Web Browser (IE6) • 28

U.S./Canada/Latin America Monday - Friday 8 a.m. - 6 p.m. ET Phone: 800-724-8090 or 732-764-8886 For CommandCenter NOC: Press 6, then Pres

Chapter 1: Introduction 2 3. Download WSDL files from the CC-SG. You can use a web browser or a simple client like wget to access the WSDL URLs.

Chapter 1: Introduction 3 a. Encryption Mode: If Require AES Encryption between Client and Server is selected in the Administration > Securit

Chapter 1: Introduction 4 Access Information WSDL URLs http://CC_IP_ADDRESS:8080/CommandCenterWebServices/AuthenticationAndAuthorizationServicePor

Chapter 1: Introduction 5 USER is the plain user name and MODULE is the name that the administrator gave the remote module configuration in CC-SG