TenantIds y uniqueTenant

    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 realizo 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)

        {
          "tenantIds": [
          ],
          "uniqueTenant": "tenant-uuid-1",
          "mappers": [
            {
              "id": "",
              "subtypes": [
      
              ],
              "tenantIds": [
                "tenant-uuid-1"
              ],
              "filter": "",
              "case": {
                "caseType": 0,
                "project": 0,
                "service": 0,
                "category": 0,
                "group": 0,
                "registryType": 0,
                "state": [
      
                ],
                "sla": 0,
                "company": 0,
                "urgency": [
      
                ]
              }
            }
          ],
          "companies": [
          ]
        }    
      

    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": [
            null,
            null
          ],
          "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):

        {
           "tenantIds":[
              "tenant-uuid-children-1"
           ],
           "uniqueTenant":"tenant-uuid-1",
           "mappers":[
              {
                 "id":"",
                 "subtypes":[
          
                 ],
                 "tenantIds":[
                   "tenant-uuid-children-1"
                 ],
                 "filter":"",
                 "case":{
                    "caseType":0,
                    "project":0,
                    "service":0,
                    "category":0,
                    "group":0,
                    "registryType":0,
                    "state":[
      
                    ],
                    "sla":0,
                    "company":0,
                    "urgency": [
      
                    ]
                 }
              }
           ],
           "companies": [
           ]
        }
      

    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 Asdk, este tipo de integración se realizara mediante la siguiente configuración:

    
    {
      "tenantIds": [
        "tenant-uuid-children-1"
      ],
      "uniqueTenant": "tenant-uuid-1",
      "mappers": [
        {
          "id": "",
          "subtypes": [
            ""
          ],
          "filter": "",
          "case": {
            "caseType": 0,
            "project": 0,
            "service": 0,
            "category": 0,
            "group": 0,
            "registryType": 0,
            "state": [
              {}
            ],
            "sla": 0,
            "company": 0,
            "urgency": [
    
            ]
          }
        }
      ],
      "companies": [
      ]
    }    
    
    

    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 Asdk.


    Tenant Específico

    La configuración permite realizar la integración de uno o varios clientes para un sólo proyectos de Asdk, este tipo de integración se realizará mediante la siguiente configuración:

    {
      "uniqueTenant": "tenant-uuid-1",
      "mappers": [
        {
          "id": "",
          "subtypes": [
            ""
          ],
          "tenantIds": [
            "tenant-uuid-children-1"
          ],
          "filter": "",
          "case": {
            "caseType": 0,
            "project": 0,
            "service": 0,
            "category": 0,
            "group": 0,
            "registryType": 0,
            "state": [
    
            ],
            "sla": 0,
            "company": 0,
            "urgency": [
    
            ]
          }
        }
      ],
      "companies": [
      ]
    }
    

    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 Asdk.

    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.*


    ↩ Volver