Glossary Item Box

Government Gateway 2.2.0 (MR-01) ISV Developer Help (Doc Version 06/03/08) | Send comments on this topic.

# Calling Methods on the Public SOAP Interface

This diagram illustrates how a UsernameToken or X509SecurityToken is used with the Security Token Service (STS) to obtain a GatewayToken, which can then be used to call methods on the SOAP Portal or Public Interfaces.

This section discusses:

- The role played by the Security Token Service (STS) and GatewayTokens.
- Calling Methods using a GatewayToken - illustrated by logging a user on to the Gateway to get a GatewayToken (RequestSecurityToken and RequestSecurityToken Response messages) and then using the returned GatewayToken to get a user's details (GsoGetUserDetails method).

Public Interface

The URL of the Web services Public Interface is https://secure.gateway.gov.uk/soap/2007/02/Public/Public.asmx. The WSDL is https://secure.gateway.gov.uk/soap/2007/02/Public/Public.asmx?wsdl.

Note:

- This endpoint is one of the set of endpoints (introduced in release 1.7.0) that fully supports the WS-* standards.
- Existing Public Interface requests can (for now) continue to use the legacy endpoint https://secure.gateway.gov.uk/soap/public/GatewaySoapPublic.asmx – however migration should be planned. The WSDL can be viewed at https://secure.gateway.gov.uk/soap/public/GatewaySoapPublic.wsdl.
- To use the SOAP Portal Interface endpoint a mutual SSL session is not required.

© Crown Copyright 2008. All rights reserved