authenticate

Important:

Browser-based authentication is not compatible with Windows Subsystem for Linux.

Grants authorization for SuiteCloud SDK to access NetSuite with an account-role combination. It requires browser-based login to NetSuite.

Important:

For this command to work, at least one of the following ports needs to be accessible locally from your machine: 52300 - 52315.

Syntax

          authenticate  [-account AccountId]
    [-url NetSuiteDomainURL]
    [-authid AuthId]

Option

Required / Optional

Description

-account

Optional

Required if the -savetoken option is specified.

Specifies your account ID.

-authid

Required

References the custom alias you give to a specific account-role combination. Referred to as authentication ID and auth ID in the documentation.

-savetoken

Optional

Specifies a TBA token that you issued previously in NetSuite.

-tokenid

Required if the -savetoken option is specified.

Specifies the token ID of a TBA token you issued previously in NetSuite.

-tokensecret

Required if the -savetoken option is specified.

Specifies the token secret of a TBA token you issued previously in NetSuite.

-url

Optional

Not required when authenticating against system.netsuite.com.

References the URL used to access the account.

If it is not specified, the production URL is used. That is, a URL such as “system.netsuite.com”.

-h or -help

Optional

Prints the help for this command.

The following command authenticates an account by prompting the browser:

sdfcli authenticate -authid myDevAccount

After the browser closes and the account-role combination is authenticated, the command produces output that is similar to the following:

Authenticating... The TBA token was successfully saved.