This document describes common issues related to Starling Connect connectors that may occur while connecting to different cloud applications using Starling Connect. It also defines how to diagnose and troubleshoot different issues concerning Starling Connect. This document will be revised by the Support team as and when information update happens.
Different errors associated with Starling Connect are detailed in this section. This section also describes different procedures to be followed to verify the error and the scenario.
The errors related to Starling Connect are as follows:
Different error scenarios associated with Error 400 are listed below:
-
Bad request when mandatory fields are missing
-
Bad request when custom mapping is missing
-
Bad request when there is an invalid input
- Bad Request when an invalid attribute name is returned in the response
The procedures to verify the above mentioned scenarios are detailed below.
Bad request when mandatory fields are missing
To verify that Starling endpoints are working
-
Copy the failed request body from One Identity Manager.
-
Paste the request body at a SCIM client (for example, Postman).
-
Perform a POST/PUT operation for the request on Starling Endpoints as required.
-
Observe the JSON response with the error description.
-
Correct the request body by adding or modifying the required fields and then, reinitiate.
-
Ensure that the core schema included in the request wrapper is accurate.
-
Apply the changes that were performed in steps 5 and 6, and send the request from One Identity Manager.
-
Check for the success of synchronization.
Bad request when custom mapping is missing
To verify that Starling endpoints are working
-
Copy the failed request body from One Identity Manager.
-
Paste the request body at a SCIM client (for example, Postman).
-
Perform a POST/PUT operation for the request on Starling endpoints as required.
-
Observe the JSON response with error description.
-
Identify the mapping that is missing.
-
Based on requirement of the connector, add or update a custom mapping in One Identity Manager.
-
Reinitiate the request from One Identity Manager
-
Check for the success of synchronization.
Bad request when there is an invalid input
To verify that Starling endpoints are working
-
Copy the failed request body from One Identity Manager.
-
Paste the request body at a SCIM client (for example, Postman).
-
Perform a POST/PUT operation for the request on Starling endpoints as required.
-
Observe the JSON response with error description.
-
Based on the error description, identify the root cause.
-
Correct the request body by adding or modifying the required fields.
Bad request when custom attribute is missing
To verify that Starling endpoints are working
-
Copy the failed request body from One Identity Manager.
-
Paste the request body at a SCIM client (for example, Postman).
-
Perform a POST/PUT operation for the request on Starling endpoints as required.
-
Observe the JSON response with error description.
-
Identify the attribute that is missing.
- Based on the invalid attribute that is mentioned in the error, log in to Starling Connect and disable the attribute. Save the connector in Starling Connect.
-
Update the schema and re-initiate the request from One Identity Manager.
-
Check for the success of synchronization.
The following table consists of error messages that are returned, if different request wrapper properties are missing.
Table 1: Error messages
Method |
Required property missing in Request Wrapper |
ClientRequest |
Required property missing in Request Wrapper |
Body |
Required property missing in Request Body |
targetURi |
Required property missing in Request Wrapper |
serviceCredentials |
Required property missing in Request Wrapper |
AuthenticationType |
enum -0 (default) |
ConfigProperties |
Required property missing in Request Wrapper |
credential information (username, password, clientID, and so on) |
Credential information missing in Request Wrapper |
ConfigProperties |
Required property missing in Request Wrapper (from connector) |
Different error scenarios associated with Error 401 Unauthorized are listed below:
- Invalid cloud application credentials
- Invalid Starling credentials
- Expired Starling Subscription
- Deleted Starling Connector connection
The procedures to rectify the error scenarios are detailed below.
Invalid cloud application credentials
To rectify the error
-
Log in to the cloud application and validate your credentials.
- Log in to the Starling account.
- Navigate to My Connectors.
- Select the required connector.
-
Edit and update the connection parameters with accurate details.
- Click Save.
Invalid Starling credentials
To rectify the error
- Log in to the Starling account.
- Navigate to My Connectors.
- Select the required connector.
- Use the Starling endpoints and credentials.
Expired Starling subscription
To rectify the error
- Log in to the Starling account.
- Navigate to My Connectors.
- If the account is expired, get it activated.
- Use the Starling endpoints and credentials.
Deleted Starling Connector connection
To rectify the error
- Log in to the Starling account.
- Navigate to My Connectors.
- Ensure that the relevant connector is available.