SuiteTalk (Web Services) Platform Guide - NetSuite

Web Services OperationsmapSso200mapSso}// Should never get here since any problems with the// logout should have resulted in a SOAP fault_console.error(getStatusDetails(status));}} else {_console.info("\nThe logout() operation cannot be invoked because there is no active session. "+ "You must be first logged on before attempting to logout.\n");}Single sign-on (SSO) refers to the procedure that allows a user of two or more userauthenticatingWeb applications to move between these applications using a browser, onlypresenting authentication information once per session.The mapSso operation supports NetSuite’s inbound single sign-on feature. This feature allowsusers to go directly from an external user-authenticating application to NetSuite, withouthaving to separately log in to NetSuite. Validation is provided by the passing of an encryptedtoken, and user identification is provided by a mapping between external applicationcredentials (company ID and user ID), and NetSuite credentials (email, password, account, androle used to log in to NetSuite).The mapSso operation streamlines the provisioning of inbound single sign-on access toNetSuite accounts by automating the mapping of credentials between an external applicationand NetSuite. If this operation is not used, this mapping is created for each user by requiringthem to log in to NetSuite on their first single sign-on access.This operation allows users to access NetSuite through inbound single sign-on withoutknowing their NetSuite password. Use of this operation is required for inbound single signintegrationsto Web store.Important: This operation provides mapping, not a login to NetSuite. This operationdoes NOT provide the ability to log in using a single sign-on token, cannotprovisian a partner with the inbound single sign-on feature, or aid withpublic/private key exchange. Use of this operation implies that the accountalready has inbound single sign-on set up and has access to the associatedpartner ID and encryption keys needed to generate the token.For more detailed information on NetSuite’s inbound single sign-on feature, see thedocumentation for Inbound Single Sign-on in the NetSuite Help Center.RequestThe MapSsoRequest type is used for this request. It contains the following fields:Element Name XSD Type NotesssoCredentials SsoCredentials Contains all the required credentials including username (emailaddress), password, account, and role, to authenticate the userand create a new session.SuiteTalk Platform Guide