NetSuite HTTP Outbound Call
When a user accesses a SuiteSignOn connection point, NetSuite issues an outbound call to start the handshake. The following is an example of this call:
GET /SSO/demoApp.php?oauth_token=05016d16126a7a6c554656421e242310060807051b17ee54e6d26986d8aa&dc=001&env=PRODUCTION&systemDomain=https%3A%2F%2F<accountID>.app.netsuite.com&webserviceDomain=https%3A%2F%2F<webservicesdomain>app.netsuite.com HTTP/1.1
Host: externalsystem.com
User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:19.0) Gecko/20100101 Firefox/19.0
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8
Accept-Language: en-US,en;q=0.5
Accept-Encoding: gzip, deflate
Connection: keep-alive
Be aware of the following:
-
This call uses the GET method to send a generated token to the external application.
-
The external application, not the local host, is the host.
-
This call includes a systemDomain and an webservicesDomain parameter. The values of the systemDomain and webservicesDomain parameters are provided by NetSuite.
Warning:The outbound HTTP call still includes a dc and an env URL parameters, but you should not use them. Using the hard-coded mapping between the dc parameter and the URL might cause problems when your account is moved to a different data center that is missing in your mapping.
-
This call also may include context information, if integration variables have been defined for the connection point on the NetSuite SuiteSignOn page.
customer_id=970
is an example of an integration variable. It could be included as a URL parameter, as follows:GET /SSO/demoApp.php?oauth_token=05016d16126a7a6c554656421e242310060807051b17ee54e6d26986d8aa &customer_id=970&dc=001&env=PRODUCTION&systemDomain=https%3A%2F%2F<accountID>.app.netsuite.com&webserviceDomain=https%3A%2F%2F<webservicesdomain>app.netsuite.com HTTP/1.1
-
URL parameters are separated by the ampersand (&). You must ensure that your code properly parses these parameters. Your code should not rely on the number or order of URL parameters, as these are subject to change.
Related Topics
- Outbound Single Sign-on (SuiteSignOn)
- SuiteSignOn Overview
- Understanding SuiteSignOn
- SuiteSignOn Sequence Diagram and Connection Details
- SuiteSignOn Required Features
- Setting Up SuiteSignOn Integration
- Creating SuiteSignOn Records
- Creating SuiteSignOn Connection Points
- Editing SuiteSignOn Records
- Creating a SuiteSignOn Bundle
- Making SuiteSignOn Integrations Available to Users
- SuiteSignOn Definitions, Parameters, and Code Samples
- Sample SuiteSignOn HTTP Calls