Credentials and Passkey Errors

Credentials File

Error Message

Scenario

Solution

There was an error editing the following credentials file: <credentialsFile>. Verify the file and folder permissions.

The application cannot modify the credentials file because the file or parent folder does not allow write access.

Remove the read-only attribute from the credentials file and ensure the user has write permissions to both the file and its parent directory. After updating the permissions, retry the operation.

The following file may be corrupted: <credentialsFile>. Delete the file and set up your account again. The authentication IDs you had set up previously will be lost.

The credentials file is corrupted or contains invalid data. For example, the file may be empty, truncated or manually modified, preventing the application from reading the API key correctly.

Delete the credentials file, then run account:setup for credentials_browser_based.p12 or account:setup:ci for credentials_ci.p12 to set up your account again.

The current passkey cannot decrypt the credentials file <credentialsFile>.

Try deleting the file and setting up your account again.

The current passkey isn't the same as the one used to create the existing credentials file.

If the passkey is set in the environment variable SUITECLOUD_FALLBACK_PASSKEY or SUITECLOUD_CI_PASSKEY, ensure that you've got the right passkey.

If you don't have the passkey for the existing credentials file, delete the credentials file from C:\Users\<username>\.suitecloud-sdk, then set up your account again with any SuiteCloud SDK tool.

Note:

When you delete the credentials file, any authentication IDs you set up before will be lost.

When you re-authenticate, a new credentials file will be generated with the correct passkey. If the passkey is set in the SUITECLOUD_FALLBACK_PASSKEY or SUITECLOUD_CI_PASSKEY environment variable, that passkey will be used to encrypt the new credentials file. Otherwise, if you use browser-based authentication, a new passkey will be generated and stored in the secure storage.

The passkey required to decrypt your credentials is missing.

Try deleting the credentials file <credentialsFile> and setting up your account again.

The passkey is missing or there is a problem with the Oracle NetSuite: Account Credentials entry in your OS secure storage.

Delete the credentials file from the C:\Users\<username>\.suitecloud-sdk folder, then set up your account again using any of the SuiteCloud SDK tools.

Note:

When you delete the credentials file, any authentication IDs you set up before will be lost.

When you re-authenticate, a new credentials file and passkey will be generated, and the passkey will be stored in the secure storage.

The credentials passkey could not be retrieved from the secure storage.

Try deleting the current credentials file <credentialsFile> and setting up your account again.

There was a problem getting the passkey from secure storage.

Delete the credentials file from the C:\Users\<username>\.suitecloud-sdk folder, then set up your account again using any of the SuiteCloud SDK tools.

Note:

When you delete the credentials file, any authentication IDs you set up before will be lost.

The credentials passkey set in the environment variable <environmentVariable> must be between 32 and 100 alphanumeric characters.

The passkey you set in the environment variable doesn't meet the requirements.

Use a passkey with 32 to 100 alphanumeric characters.

The credentials passkey set in secure storage must be between 32 and 100 alphanumeric characters.

The passkey stored in secure storage doesn't meet the requirements.

Delete the credentials file from the C:\Users\<username>\.suitecloud-sdk folder, then set up your account again using any of the SuiteCloud SDK tools.

Note:

When you delete the credentials file, any authentication IDs you set up before will be lost.

API Key File

Error Message

Scenario

Solution

There was an error editing the Client API Key file <clientAPIkeyFile>. Verify the file and folder permissions.

The application cannot modify the Client API Key file because the file or parent folder does not allow write access.

Remove the read-only attribute from the Client API Key file and ensure the user has write permissions to both the file and its parent directory. After updating the permissions, retry the operation.

There was an error reading the Client API Key file <clientAPIkeyFile>. Verify the file and folder permissions.

The application cannot access the Client API Key file because the file or parent folder does not allow read access.

Verify that the Client API Key file exists and grant read permissions to the user. Also confirm that the parent directory allows access. After updating the permissions, retry the operation.

The Client API Key file <clientAPIkeyFile> may be corrupted. Delete the file and generate a new API key. You'll need to update the API key in all product configurations you're using.

The Client API Key file is corrupted or contains invalid data. For example, the file may be empty, truncated, or manually modified, preventing the application from reading the API key correctly.

Delete the Client API Key file and run suitecloud proxy:generatekey to generate a new API key.

Note:

Generating a new API key replaces the previous key. After generating a new key, you must update the API key configuration in all third-party tools that use SDA.

For more information, see Using SuiteCloud Developer Assistant with Cline in WebStorm.

The current passkey cannot decrypt the Client API Key file <clientAPIkeyFile>.

Try deleting the file and generating a new Client API key.

The passkey currently configured in the environment variable is different from the passkey that was used to encrypt the existing Client API Key file. The file cannot be decrypted.

Verify that the configured passkey matches the passkey that was used when the Client API Key file was created. If the original passkey is unavailable, delete the Client API Key file and generate a new API key using the current passkey. To do this, run suitecloud proxy:generatekey.

Note:

Generating a new API key replaces the previous key. After generating a new key, you must update the API key configuration in all third-party tools that use SDA.

For more information, see Using SuiteCloud Developer Assistant with Cline in WebStorm.

The credentials passkey set in the environment variable <environmentVariable> must be between 32 and 100 alphanumeric characters.

The passkey you set in the environment variable doesn't meet the requirements.

Use a passkey with 32 to 100 alphanumeric characters.

The passkey for the Client API Key file stored in secure storage must be between 32 and 100 alphanumeric characters.

The passkey stored in secure storage doesn't meet the requirements.

Use a passkey with 32 to 100 alphanumeric characters.

Related Topics

General Notices