public interface HTTPDestination extends Destination, com.sap.security.core.server.destinations.api.HTTPDestinationConstantsInterface
As with all destinations, please note, that all changes done to the
destination are local and not (!) persisted in the destination service
automatically. The destination service persistence is changed solely
when method DestinationService.storeDestination
is called
for storing a new destination instance, respectively
DestinationService.updateDestination
is called for changing
an existing destination.
DestinationService.storeDestination(java.lang.String, com.sap.security.core.server.destinations.api.Destination)
,
DestinationService.updateDestination(java.lang.String, com.sap.security.core.server.destinations.api.Destination)
Modifier and Type | Field and Description |
---|---|
static String |
HTTP_NON_PROXY_HOSTS |
static String |
HTTP_PROXY_HOST
Standard Java proxy parameter names
|
static String |
HTTP_PROXY_PORT |
static String |
HTTPS_NON_PROXY_HOSTS |
static String |
HTTPS_PROXY_HOST |
static String |
HTTPS_PROXY_PORT |
AUTHENTICATION_ASSERTION_TICKET, AUTHENTICATION_ASSERTION_TICKET_ENCODED, AUTHENTICATION_BASIC, AUTHENTICATION_BASIC_PASSWORD, AUTHENTICATION_BASIC_USERNAME, AUTHENTICATION_CLIENT_X509_KEYSTORE_CERTIFICATE, AUTHENTICATION_CLIENT_X509_KEYSTORE_VIEW, AUTHENTICATION_NONE, AUTHENTICATION_SSO2, AUTHENTICATION_SSO2_TICKET, AUTHENTICATION_SSO2_TICKET_ENCODED, AUTHENTICATION_TOKEN_NAME, AUTHENTICATION_TOKEN_VALUE, AUTHENTICATION_TYPE, AUTHENTICATION_USER_MAPPING, AUTHENTICATION_X509, CHOICE_URL_CUSTOM, CHOICE_URL_DEFAULT, CHOICE_URL_SLD, DEFAULT_URL, DEFAULT_URL_PROPERTY, DESTINATION_TYPE, DESTINATION_URL, LCR_PUBLISH, PROXY_ENABLED, PROXY_URL, SAP_CLIENT, SAP_LANGUAGE, SAP_SID, SLD_URL, SLD_WS_NAME_PROPERTY, SLD_WS_PORT_PROPERTY, SLD_WS_SUPPORT_PROPERTY, SLD_WS_SYSTEM_NAME_PROPERTY, SSL_SERVER_AUTHENTICATION_IGNORE, SSL_SERVER_AUTHENTICATION_KEYSTORE_VIEW, SSL_SERVER_AUTHENTICATION_TYPE, TYPE_PROPERTY, URL_CHOICE
Modifier and Type | Method and Description |
---|---|
String |
getAuthenticationType() |
String |
getClient()
Note: When using getHTTPConnectionTemplate, client and language are not set on the connection template
and must be set directly on the IRequest object by using the setSAPHeaders method.
|
com.tssap.dtr.client.lib.protocol.IConnectionTemplate |
getHTTPConnectionTemplate() |
String |
getLanguage()
Note: When using getHTTPConnectionTemplate, client and language are not set on the connection template
and must be set directly on the IRequest object by using the setSAPHeaders method.
|
String |
getSID() |
Socket |
getSocket()
Return a socket to the server specified in the URL field of the destination.
|
String |
getUrl() |
HttpURLConnection |
getURLConnection()
Creates an HTTPURLConnection to the specified URL.
|
HttpURLConnection |
getURLConnection(String requestMethod)
This has the same functionality as
getURLConnection() ,
but it allows setting of the HTTP Request Method before setting
the BASIC authentication data. |
boolean |
isIgnoreServerCertificates() |
void |
setAcceptedServerCertificates(String view)
Set the accepted server certificates.
|
void |
setAssertionTicketAuthentication()
Set the authentication to SAP Assertion Ticket.
|
void |
setAuthenticationToken(String authTokenProviderID)
Set the authentication to the specified custom authentication token
|
void |
setClient(String string)
Sets the Client configured for this destination.
|
void |
setClientCertificateAuthentication(String view,
String alias)
Set the authentication to X.509 Client Certificates.
|
void |
setIgnoreServerCertificates(boolean ignoreServerCertificates)
Set if server certificates should be accepted.
|
void |
setLanguage(String string)
Set the language configured for this destination.
|
void |
setNoAuthentication()
Sets the authentication method to none.
|
void |
setSAPHeaders(com.tssap.dtr.client.lib.protocol.IRequest request)
Set the SAP specific headers like language and client.
|
void |
setSID(String string)
Set the system identifier configured for this destination.
|
void |
setSSO2Authentication()
Set the authentication to SAP Logon Ticket.
|
void |
setUrl(String url)
Set the URL.
|
void |
setUserMappingAuthentication(String creationClassName,
String name)
Set the authentication to SLD user mapping.
|
void |
setUsernamePassword(String username,
String password)
Sets the authentication method to HTTP basic, and sets the username and the password.
|
getDestinationProperties, getName, init, isPublishedToLCR, publishToLCR, setDestinationProperties, setName
static final String HTTP_PROXY_HOST
static final String HTTP_PROXY_PORT
static final String HTTP_NON_PROXY_HOSTS
static final String HTTPS_PROXY_HOST
static final String HTTPS_PROXY_PORT
static final String HTTPS_NON_PROXY_HOSTS
Socket getSocket() throws ConfigurationException
Does not support HTTP/S proxies
ConfigurationException
- if the configuration can not be used by the destination serviceHttpURLConnection getURLConnection() throws ConfigurationException
ConfigurationException
- if the configuration can not be used by the destination service.
Supports HTTP/S proxies.HttpURLConnection getURLConnection(String requestMethod) throws ConfigurationException
getURLConnection()
,
but it allows setting of the HTTP Request Method before setting
the BASIC authentication data. This is a workaround for a
program error in the underlying IAIK HTTP implementation which in this
case generates GET request even if another method is set. Supports HTTP/S proxies.
requestMethod
- The HTTP Request MethodHttpURLConnection
with preset request method.ConfigurationException
- if the configuration can not be used by the destination service.com.tssap.dtr.client.lib.protocol.IConnectionTemplate getHTTPConnectionTemplate() throws ConfigurationException
Note: When using getHTTPConnectionTemplate, client and language are not set on the connection template
and must be set directly on the IRequest object by using the setSAPHeaders method.
Supports HTTP/S proxies.
ConfigurationException
- if the configuration can not be used by the destination service.String getAuthenticationType()
HTTPDestinationConstantsInterface
void setNoAuthentication()
void setUsernamePassword(String username, String password)
username
- the username to be setpassword
- the password to be setvoid setClientCertificateAuthentication(String view, String alias)
view
- the keystore viewalias
- the keystore view aliasvoid setSSO2Authentication()
Note that for ticket-based authentication, trust has to be configured between the system hosting the destination and the system that the destination points to.
void setAssertionTicketAuthentication()
Note that for ticket-based authentication, trust has to be configured between the system hosting the destination and the system that the destination points to. Furthermore, SID and Client have to be specified for a destination that is to be configured with assertion ticket authentication. These two properties are added to the ticket and are required at the target system to successfully evaluate the ticket.
void setUserMappingAuthentication(String creationClassName, String name) throws DestinationException
The UME maintains an association of the type local user x - remote system y - remote user z. Therefore, if user mapping is configured, the destination service looks up the remote user z to be used for remote system y for the currently logged in local user x.
This data can be retrieved from the SLD:
CreationClassName
: string 256 key. Indicates the name of the class or the subclass used in
the creation of an instance. When used with the other key properties of this class, this
property allows all instances of this class and its subclasses to be uniquely identified.
Name
: string 256 key. The inherited Name serves as key of a System instance in an
enterprise environment.
creationClassName
- The SLD-type of the target system. CIM-Property: SLDElementNames.P_CreationClassName
name
- The SLD-name of the target system. CIM-Property: SLDElementNames.P_Name
DestinationException
- if the queried destination does not existvoid setAcceptedServerCertificates(String view)
view
- the keystore viewvoid setIgnoreServerCertificates(boolean ignoreServerCertificates)
ignoreServerCertificates
- true
if the server certificates should be ignoredboolean isIgnoreServerCertificates()
void setUrl(String url)
url
- the URL for this destinationString getUrl()
void setClient(String string)
string
- the Client for this destinationString getClient()
Note: When using getHTTPConnectionTemplate, client and language are not set on the connection template and must be set directly on the IRequest object by using the setSAPHeaders method.
void setLanguage(String string)
string
- the language for this destinationString getLanguage()
Note: When using getHTTPConnectionTemplate, client and language are not set on the connection template and must be set directly on the IRequest object by using the setSAPHeaders method.
void setSID(String string)
string
- the system ID for this destinationString getSID()
void setSAPHeaders(com.tssap.dtr.client.lib.protocol.IRequest request)
As they can not be set on the IConnectionTemplate, this method must be called to set them before making an request.
request
- SAP specific headers like language and clientvoid setAuthenticationToken(String authTokenProviderID)
authTokenProviderID
- The ID of the HTTPAuthenticationTokenProvider
implementation which will provide the tokenAccess Rights |
---|
SC | DC | Public Part | ACH |
---|---|---|---|
[sap.com] ENGFACADE
|
[sap.com] tc/bl/security/destinations/api
|
api
|
BC-JAS-SEC
|
[sap.com] J2EE-FRMW
|
[sap.com]
|
-
|
BC-JAS-SEC
|
[sap.com] J2EE-FRMW
|
[sap.com]
|
default
|
BC-JAS-SEC
|
Copyright 2018 SAP AG Complete Copyright Notice