semi合集-English.pdf - 第3389页

SEMI E132.1-0305 © SEMI 2005 16 Table 12 SecurityA dmin Port Type SEMI E132 Class Name Security Admin WSDL Port Type Name Se curityAdmin SEMI E132 Operation  WSDL Operation GetDefinedPrivileges  GetDefinedPrivileges Ge…

100%1 / 7923
SEMI E132.1-0305 © SEMI 2005 15
Table 10 SecurityAdmin PortType Definitions
File Name E132-1-V0305-SecurityAdmin-PortType.wsdl
Target Namespace urn:semi-org:ws.E132-1.V0305.secAdmin-portType
Imported/Referenced
Namespaces
urn:semi-org:xsd.E132-1.V0305.auth
http://schemas.xmlsoap.org/wsdl/
http://www.w3.org/2001/XMLSchema
Description
This file defines all of the input/output messages and operations for the SecurityAdmin interface,
based on the data types defined in the SEMI E132 XML Schema.
Table 11 SecurityAdmin Binding Definitions
File Name E132-1-V0305-SecurityAdmin-Binding.wsdl
Target Namespace urn:semi-org:ws.E125-1.V0305.secAdmin-binding
Imported/Referenced
Namespaces
urn:semi-org:ws.E132-1.V0305.secAdmin-portType
http://schemas.xmlsoap.org/wsdl/soap/
http://schemas.xmlsoap.org/wsdl/
Description
This file binds the abstract portType definition to HTTP and SOAP, specifying required SOAP
and HTTP headers for each operation and the XML encoding style for the SecurityAdmin
interface.
8.2.2.2 These documents are a part of this specification and should accompany this document. The contents of
these documents constitute the core part of this specification.
8.2.3 WSDL Port Type Overview
8.2.3.1 The SecurityAdmin WSDL portType definition organizes the SEMI E132.1 XML Schema data types into a
collection of named operations with inputs and outputs that correspond to the UML operations that are defined for
the SecurityAdmin interface in SEMI E132. The WSDL portType itself is named after the SEMI E132 interface,
and each WSDL portType operation is named after the corresponding UML operation defined for the interface.
Each WSDL operation consists of two WSDL message definitions corresponding to the input and output (request
and response) for the UML operation defined in SEMI E132. Figure 7 illustrates the relationship between the SEMI
E132 UML interface and the WSDL portType definition; Table 12 describes this in tabular form. The WSDL
message and operation definitions are described in ¶¶8.2.9 through 8.2.15.
Figure 7
Mapping the SecurityAdmin interface to a WSDL portType
SEMI E132.1-0305 © SEMI 2005 16
Table 12 SecurityAdmin Port Type
SEMI E132 Class Name SecurityAdmin
WSDL Port Type Name SecurityAdmin
SEMI E132 Operation
WSDL Operation
GetDefinedPrivileges GetDefinedPrivileges
GetACL GetACL
AddACLEntry AddACLEntry
DeleteACLEntry DeleteACLEntry
GetActiveSessions GetActiveSessions
SetMaxSessions SetMaxSessions
GetMaxSessions GetMaxSessions
8.2.4 WSDL Binding Overview
8.2.4.1 The WSDL SecurityAdmin binding definition specifies a message and transport protocol to use for a given
portType (SOAP and HTTP for SEMI E132.1), the interface style used (document style for SEMI E132.1). These
settings are shown in Table 13. For each WSDL portType operation, the binding defines any SOAP headers used
and whether or not they are required, the HTTP SOAPAction header value to use for that operation, and the XML
encoding to use (literal for SEMI E132.1). The binding definitions for each portType operation are described in
¶¶8.2.9 through 8.2.15.
Table 13 SecurityAdmin Binding
SEMI E132 Class Name SecurityAdmin
WSDL Binding Name SecurityAdminBinding
SOAP Binding Style document
SOAP Transport http://schemas.xmlsoap.org/soap/http
8.2.5 WSDL Service Overview
8.2.5.1 This specification does not provide a WSDL service definition. WSDL service definitions provide one way
to define and locate the endpoint(s) at which a given interface can be accessed by a client. Such information cannot
be determined until the equipment has been installed on a factory network, and therefore is out of scope for this
specification. Users are responsible for defining the mechanisms by which clients locate SEMI E132 equipment
services in the factory. A sample SecurityAdmin service definition is provided in Figure 8 for reference only.
<?xml version="1.0" encoding="UTF-8"?>
<
wsdl:definitions name="SecurityAdmin"
xmlns="urn:semi-org:ws.E132-1.V0305.secAdmin-service"
targetNamespace="urn:semi-org:ws.E132-1.V0305.secAdmin-service"
xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
xmlns:wsdl=http://schemas.xmlsoap.org/wsdl/
xmlns:SABind="urn:semi-org:ws.E132-1.V0305.secAdmin-binding">
<wsdl:import namespace="urn:semi-org:ws:E132-1.V0305.secAdmin-binding"
location="E132-1-V0305-SecurityAdmin-Binding.wsdl"/>
<wsdl:service name="SecurityAdmin">
<wsdl:port name="SecurityAdminPort" binding="SABind:SecurityAdminBinding" >
<soap:address location="https://www.someplace/SecurityAdmin"/>
</wsdl:port>
</wsdl:service>
</
wsdl:definitions>
Figure 8
Sample SecurityAdmin WSDL Service definition
SEMI E132.1-0305 © SEMI 2005 17
8.2.6 SEMI E132 Operation Errors
8.2.6.1 Common Error
8.2.6.1.1 All errors returned by SEMI E132 operations uses the Error type defined in SEMI E138. The common
error is in addition to any custom error construct that may be defined by each operation to provide additional context
relevant to the operation and a specific error. The common error type defines 2 attributes, “source” and “code”; see
Common Components Specification for more detailed information. All E132 defined errors shall set the “source”
attribute to “urn:semi-org:E132”. The error codes for SEMI E132 defined errors are provided in Table 14.
Description is a textual description of the error. The Extension element allows equipment suppliers to provide more
detailed information regarding the error using XML content defined by the supplier.
8.2.6.1.2 Table 14 below provides a mapping of the SEMI E132 defined errors to its common error code. The
SEMI E132 Error column matches the error description of each defined error in the SEMI E132 specification. Errors
during the Authentication message exchange are as defined by the SSL authentication protocol. The SEMI E132
mapped error codes below are in addition to any common error codes defined in the Common Components
Specification.
Table 14 SEMI E132 Error Codes
SEMI E132 Error Common Error Code
Operation not authorized 6000
Duplicate ACL entry found 6001
Unrecognized role 6002
Unrecognized privilege 6003
ACL entry not found 6004
Unrecognized session 6005
Max session limit exceeded 6006
8.2.6.2 Unauthorized Operation Error
8.2.6.2.1.1 Many operations may return an operation not authorized error (common error code 6000). For this
error, SEMI E132 defines a specific UnauthorizedOperationError structure to provide additional context information
such as list of all the privileges that grant authorization for the requested operation.
8.2.6.2.1.2 The UnauthorizedOperationError class is mapped to the XML UnauthorizedOperationType. Table 15
shows how the attributes and associations of UnauthorizedOperationError class are mapped to XML. Figure 9
shows the XML Schema diagram.
Table 15 Translation Table for UnauthorizedOperationError Class
Attribute or Role Name UML Name/Type XML Element or Attribute XML Name/Type
description Text Element Description: xsd:string
requiredPrivileges Association Element RequiredPrivilege: PrivilegeType (one
or more)
Figure 9
UnauthorizedOperationType XML Schema Type
8.2.7 Session Identifier