The Aha! connector allows you to connect Aha! with One Identity Starling enabling you to take advantage of the features and products available with Starling Connect that complement and enhance the services provided by Aha!

Aha! is a product management software that enables software companies to collaborate across cross functional teams.

Supervisor configuration parameters

To configure the connector, following parameters are required:

• Connector name

• Api Key

• Target URI

• Instance DateTime Offset (refer Configuring additional datetime offset in connectors for more details).

Supported objects and operations

Users

Table 289: Supported operations for Users

Operation	VERB
Create User	POST
Update User	PUT
Delete User (soft delete)	DELETE
Get User	GET
Get All users	GET
Get All Users with Pagination	GET

Roles

Table 290: Supported operations for Roles

Operation	VERB
Get Role by Id	GET
Get all Roles	GET

Products

Table 291: Supported operations for Products

Operation	VERB
Get Product by Id	GET
Get all Products	GET
GET All Products with Pagination	GET

Mandatory fields

Users

• Name.GivenName

• Name.FamilyName

• EmailAddress

• role

• product_id

Groups

Not Applicable

Mappings

Table 292: User mapping

SCIM Parameter	Aha parameter
Id	id
UserName	email
DisplayName	name
emails[].value	email
Active	enabled
name.givenName	first_name (not returned, only writable)
name.familyName	last_name (not returned, only writable)
Extension.productRoles[].role	product_roles[].role
Extension.productRoles[].productId	product_roles[].product_id
Extension.productRoles[].productName	product_roles[].product_name
Meta.Created	created_at
Meta.LastModified	updated_at

Roles

Table 293: Roles mapping

SCIM parameter	Aha parameter
id	id
name	name

Products

Table 294: Products mapping

SCIM parameter	Aha parameter
id	id
name	name
referencePrefix	reference_prefix
productLine	product_line
productLineType	product_line_type
url	url
resource	resource
children[].id	children[].id
children[].referencePrefix	children[].reference_prefix
children[].name	children[].name
children[].productLine	children[].product_line
capacityPlanningEnabled	capacity_planning_enabled
defaultCapacityUnits	default_capacity_units
Meta.Created	created_at
Meta.LastModified	updated_at

Connector limitations

1. Aha accepts Role and Product assignment of Users in a combined form and they cannot be assigned separately.

2. Aha accepts an invalid target URL and returns the results when the API key provided is valid. Due to this behavior, the Test Connection on Starling Connect UI will be successful even without a valid target URI.

3. Teams and Groups are not supported because Aha does not provide APIs to create or manage them.

4. Connector supports cursor pagination for the object types Users and Products. It does not support cursor pagination for the Roles object type. However, the records returned are in multiples of 100. For example, if 255 records are requested, connector returns 300 records (next nearest multiple of 100s of the count).

5. Aha supports only soft delete of Users. Users are set to inactive when the Delete operation is performed. The same User can be reactivated by passing active flag set to True. However, the deleted User can be retrieved in the list of Users as well as individually, irrespective of the status.

6. No error is returned when a nonexistent Role is specified in the Create and Update request. However, the operation would be completed with a default Role assigned to the User.

7. Invalid Product ID specified in User Create and User Update request would return Error 404 with message ‘Not Found’.

For more information, see Synchronization and integration of Roles object type with One Identity Manager.

Synchronization and integration of Products object type with One Identity Manager

For more information, see Synchronization and integration of Products object type with One Identity Manager.

Add Roles ID and Product ID to create and update users for Aha connector

To create a user successfully using Aha connector, you must provide valid values for mandatory properties such as Roles and Products ID in the request. Roles and Products ID are the sub-attributes of the main attribute ProductRoles, which is a complex multi-valued string attribute defined under User extensions in the connector schema.

One Identity Manager must have fields where you can enter complex multi-value array values but it does not display such fields by default. However, it is possible to create custom multi-value array fields. For more information, see Creating multi-valued custom fields in One Identity Manager.