WebServiceAuth

Web Service Authorization

Purpose: Use the Web Service Authorization screen to work with authentication requirements for web services. By setting up and requiring user IDs and passwords for web services, you confirm that Order Broker authenticates the identify of the system submitting web service requests.

If authentication is required and Order Broker receives a web service request without a valid web service user and password, the request is refused with an error: Inbound Message failed validation.

Authentication is required by default.

In this topic:

• Options at this screen

• Fields at this screen

How to display this screen: Select Web Service Authorization from the Systems Menu.

Note: Only users with Web Service Authorization authority can display this screen. See the Role Wizard for more information.

Options at this screen

Option	Procedure
switch a web service’s authentication requirement setting	The disabled icon () indicates that the web service does not require authentication; otherwise, the enabled icon () indicates that authentication is required. To switch between the settings, click the icon that is currently displayed. Before turning on authentication for a web service: • Confirm that each integrating system that needs to use the web service supports web service authentication. • Set up at least one user name and password for integrating systems to supply for web service authentication.
work with web service users	Click the edit icon () for a web service to advance to the Web Service User screen, where you can work with users and passwords identifying systems that use the web service.

Option

Procedure

switch a web service’s authentication requirement setting

The disabled icon () indicates that the web service does not require authentication; otherwise, the enabled icon () indicates that authentication is required. To switch between the settings, click the icon that is currently displayed.

Before turning on authentication for a web service:

• Confirm that each integrating system that needs to use the web service supports web service authentication.

• Set up at least one user name and password for integrating systems to supply for web service authentication.

work with web service users

Click the edit icon () for a web service to advance to the Web Service User screen, where you can work with users and passwords identifying systems that use the web service.

Fields at this screen

Field	Description
Search fields:
Web Service	Optionally, enter a full or partial web service name and click Search to display the web service that starts with or matches your entry. Case-insensitive for searching; for example, an entry of d does not match a web service of Discovery.
Auth Required	Optionally, select Yes and click Search to display web services that are set to require authentication, or select No and click Search to display web services that do not require authentication.
Results fields:
Web Service	A Order Broker web service: • Discovery: Requests include Location discovery and System discovery. • Locate: Includes all requests related to the Routing Engine: • EchoTest • Fulfillments • LocateItems • OrderSearch • OrderUpdate • ProductAvailability • ProductUpdate • StatusListRequest • StatusRequest • StatusUpdate • SubmitOrder • Purchasing: Includes all requests related to the Supplier Direct Fulfillment module: • CreateDSOrder • CreateDSVendor • GetDSChanges • GetDSInvoices • SetDSAddressChange • SetDSCancel • SetDSCostChange Note: Authentication is supported only for messages between Order Broker and the retailer. The integrated vendor messages do not require authentication. For more information: See the Operations Guide for details on these messages.
Auth Required	The disabled icon () indicates that the web service does not require authentication; otherwise, the enabled icon () indicates that authentication is required. To switch between the settings, click the icon that is currently displayed. Before turning on authentication for a web service: • Confirm that each integrating system that needs to use the web service supports web service authentication. • Set up at least one user name and password for integrating systems to supply for web service authentication.
Edit	Click the edit icon () for a web service to advance to the Web Service User screen, where you can work with users and passwords identifying systems that use the web service.

________________________________