Tenants de HP TechPulse
Las APIs de TechPulse necesitan identificadores únicos de empresa, dispositivo y usuario de tipo GUID, estos identificadores pueden obtenerse mediante el siguiente endpoint:
GET /analytics/v1/identity/tenants
Obteniendo la siguiente respuesta
{
"schemas": [
"urn:scim:schemas:core:2.0:Tenant"
],
"id": "tenant-uuid-1",
"displayName": "Customer Name",
"description": "",
"tenantType": "CUSTOMER",
"subTypes": [],
"phoneNumber": {
"value": "555-5555",
"type": "work"
},
"ownerId": "test-emailid@email.com"
}
⚐ Nota: Esta solicitud se realizó en la autenticación para obtener el refresh-token.
Para más información de tenants consulte la documentación de HP TechPulse Ver documentación HP TechPulse
-
Agregue el “ID” en el archivo de configuración de la siguiente manera:
Tome el id de la respuesta obtenida anteriormente y escriba en las secciones de “uniqueTenant” (tenant de tipo cliente)
{ "companies": [ ], "tenantIds": [ ], "uniqueTenant": "tenant-uuid-1", "mappers": [ { "id": "", "subtypes": [ ], "tenantIds": [ ], "filter": "", "case": { "category": 0, "ci": 0, "company": 0, "customer": 0, "itemType": "", "project": 0, "reason": 0, "service": 0, "sla": 0, "state": [ ], "urgency": [ ], "additionalFields": [ ] } } ] }
Tenants asociados:
Los tenant de tipo cliente pueden tener asociados “tenants” de tipo dispositivo y/o compañía. Para obtener los identificadores, consulte el siguiente API:
GET /analytics/v1/identity/tenants/children
⚐ Nota: El tipo de autenticación es OAuth 2.0
Obteniendo la siguiente respuesta
{
"schemas": [
"urn:scim:schemas:core:2.0:ListResponse"
],
"totalResults": 7,
"startIndex": 0,
"itemsPerPage": 7,
"resources": [
{
"id": "tenant-uuid-children-1",
"displayName": "Children 1",
"type": "CUSTOMER",
"ownerId": "xxx",
"status": "Active",
"subscriptionState": "OVER_ENROLLED",
"owner": {
"..."
},
"parents": [
{
"id": "tenant-uuid-parent-1",
"association": "xxxx",
"name": "xxx xxx",
"primaryAdministrator": {
"xxxx"
}
},
"..."
],
"subTypes": [
],
"lastImpersonatedOn": "2020-11-27 16:39:43 UTC",
"impersonatedBy": "xxxx-xxxx-xxxx-xxxx"
},
"..."
]
}
-
Agregue el los tenants asociados en el archivo de configuración de la siguiente manera:
Tome el id de los recursos en la respuesta obtenida anteriormente y escriba en las secciones de “tenantIds” (tenants de tipo cliente, dispositivo y compañía):
Tome el id de la respuesta antes obtenida y escriba en las secciones de “tenantIds” (tenants de tipo cliente, dispositivo y compañía) y “uniqueTenant” (tenant de tipo cliente)
{ "tenantIds": [ "tenant-uuid-children-1" ], "companies": [ ], "uniqueTenant": "tenant-uuid-1", "mappers": [ { "tenantIds": [ "tenant-uuid-children-1" ], "case": { "customer": 0, "company": 0, "category": 0, "ci": 0, "itemType": "", "project": 0, "service": 0, "reason": 0, "sla": 0, "state": [ ], "urgency": [ ], "additionalFields": [ ] }, "filter": "", "subtypes": [ ] } ] }
Configurar tenants asociados en archivo de integración
Tenant Global
La configuración permite realizar la integración de uno o varios clientes para diferentes configuraciones de casos en ASMS, este tipo de integración se realizará mediante la siguiente configuración:
{
"tenantIds": [
"tenant-uuid-1"
],
"uniqueTenant": "tenant-uuid-1",
"companies": [
],
"mappers": [
{
"case": {
"customer": 0,
"company": 0,
"category": 0,
"ci": 0,
"itemType": "",
"project": 0,
"service": 0,
"reason": 0,
"sla": 0,
"state": [
],
"urgency": [
],
"additionalFields": [
]
},
"filter": "",
"subtypes": [
]
}
]
}
Los identificadores únicos de empresa, dispositivo y usuario se agregan de forma global en la propiedad “tenantIds” permitiendo filtrar los incidentes de Hp TechPulse e importándolos hacia ASMS.
Tenant Especifico
La configuración permite realizar la integración de uno o varios clientes para un sólo proyecto de ASMS, este tipo de integración se realizará mediante la siguiente configuración:
{
"uniqueTenant": "tenant-uuid-1",
"companies": [
],
"mappers": [
{
"tenantIds": [
"tenant-uuid-1"
],
"case": {
"customer": 0,
"company": 0,
"category": 0,
"ci": 0,
"itemType": "",
"project": 0,
"service": 0,
"reason": 0,
"sla": 0,
"state": [
],
"urgency": [
],
"additionalFields": [
]
},
"filter": "",
"subtypes": [
]
}
]
}
Los identificadores únicos de empresa, dispositivo y usuario se agregan en la propiedad “tenantIds” permitiendo que cada empresa, dispositivo y usuario tenga una configuración única al crear casos en ASMS.
Consideraciones:
- La configuración con tenants específicos tiene prioridad sobre la configuración de los tenants globales, si se presenta el caso de tener los “tenantIds” de forma específica y global el sistema da prioridad a los específicos ignorando los tenants agregados de forma global.
- Si no se agrega la propiedad tenantIds (global o específica), el sistema toma como referencia la propiedad uniqueTenant.*