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