1. Edición de activos digitales de Oracle Blockchain Platform
  2. Mejoras en Blockchain App Builder
  3. Roles de auditor

Roles de auditor

La versión mejorada de Blockchain App Builder incluye soporte para roles de auditor al utilizar el estándar ampliado de Token Taxonomy Framework.

La versión de Blockchain App Builder proporcionada con Digital Assets Edition de Oracle Blockchain Platform soporta dos roles adicionales para proyectos de código de cadenas que utilizan el estándar ampliado de Token Taxonomy Framework. Los nuevos roles son Token Auditor y Org Auditor. Estos roles funcionan de forma similar a los roles Token Admin y Org Admin, pero los roles de auditor están limitados al acceso de solo lectura. Los roles de administrador tienen acceso de lectura y escritura.

La siguiente información describe los métodos de controlador y los métodos de SDK que soportan roles de auditor tanto en TypeScript como en Go.

Métodos de controlador TypeScript

Los siguientes métodos de controlador admiten las funciones de rol de auditor.
addTokenAuditor
Este método agrega un usuario como Token Auditor del código de cadenas. Este método solo puede ser llamado por Token Admin del código de cadenas. 
public async addTokenAuditor(org_id: string, user_id: string)
Parámetros:
  • org_id: string: ID del proveedor de servicios de afiliación (MSP) del usuario en la organización actual.
  • user_id: string: nombre de usuario o ID de correo electrónico del usuario.
Devuelve:
  • Cuando se realiza correctamente, un mensaje que incluye detalles del usuario que se agregó como Token Auditor del código de cadenas.
Ejemplo de Valor de Devolución:
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "cd81f6c4c9e7c18ece357dbf5c139ef66ef2d6566be3b14de5f6d0a3fd4bb2f0",
        "payload": {
            "msg": "Successfully added Token Auditor (Org_Id: CB, User_Id: cb)"
        },
        "encode": "JSON",
        "sourceURL": "cb-oabcs1-bom.blockchain.ocp.example.com:20009",
        "blockNumber": 196
    }
}
removeTokenAuditor
Este método elimina un usuario como Token Auditor del código de cadenas. Este método solo puede ser llamado por Token Admin del código de cadenas. 
public async removeTokenAuditor(org_id: string, user_id: string)
Parámetros:
  • org_id: string: ID del proveedor de servicios de afiliación (MSP) del usuario en la organización actual.
  • user_id: string: nombre de usuario o ID de correo electrónico del usuario.
Devuelve:
  • Cuando se realiza correctamente, un mensaje que incluye detalles del usuario que se eliminó como Token Auditor del código de cadenas.
Ejemplo de Valor de Devolución:
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "a886a6040fbc76374a3c78c89ab0ffc9f7b8391cc5239b169bf3b878cf40c67b",
        "payload": {
            "msg": "Successfully removed Token Auditor (Org_Id: CB, User_Id: cb)"
        },
        "encode": "JSON",
        "sourceURL": "cb-oabcs1-bom.blockchain.ocp.example.com:20010",
        "blockNumber": 219
    }
}
getTokenAuditors
Este método devuelve todo Token Auditors del código de cadenas. Este método solo puede ser llamado por Token Admin o Token Auditor del código de cadenas. 
public async getTokenAuditors()
Ejemplo de Valor de Devolución:
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "payload": {
            "auditors": [
                {
                    "org_id": "CB",
                    "user_id": "auditor_user_cb"
                }
            ]
        },
        "encode": "JSON"
    }
}
addOrgAuditor
Este método agrega un usuario como Org Auditor del código de cadenas. Este método solo puede ser llamado por Token Admin o Org Admin del código de cadenas. 
public async addOrgAuditor(org_id: string, user_id: string)
Parámetros:
  • org_id: string: ID del proveedor de servicios de afiliación (MSP) del usuario en la organización actual.
  • user_id: string: nombre de usuario o ID de correo electrónico del usuario.
Devuelve:
  • Cuando se realiza correctamente, un mensaje que incluye detalles del usuario que se agregó como Org Auditor del código de cadenas.
Ejemplo de Valor de Devolución:
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "44bbad35a1478cb714e32f7cfd551897868a203520aab9cea5771d3aadc1cf03",
        "payload": {
            "msg": "Successfully added Org Auditor (Org_Id: CB, User_Id: cb)"
        },
        "encode": "JSON",
        "sourceURL": "cb-oabcs1-bom.blockchain.ocp.example.com:20009",
        "blockNumber": 198
    }
}
removeOrgAuditor
Este método elimina un usuario como Org Auditor del código de cadenas. Este método solo puede ser llamado por Token Admin o Org Admin del código de cadenas. 
public async removeOrgAuditor(org_id: string, user_id: string)
Parámetros:
  • org_id: string: ID del proveedor de servicios de afiliación (MSP) del usuario en la organización actual.
  • user_id: string: nombre de usuario o ID de correo electrónico del usuario.
Devuelve:
  • Cuando se realiza correctamente, un mensaje que incluye detalles del usuario que se eliminó como Org Auditor del código de cadenas.
Ejemplo de Valor de Devolución:
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "c3bc720461004a53b37c68d4bb264858b88d980bc093a0a3ebb62a32974fb306",
        "payload": {
            "msg": "Successfully removed Org Auditor (Org_Id: CB, User_Id: cb)"
        },
        "encode": "JSON",
        "sourceURL": "cb-oabcs1-bom.blockchain.ocp.example.com:20010",
        "blockNumber": 221
    }
}
getOrgAuditors
Este método devuelve todo Org Auditors del código de cadenas. Este método solo puede ser llamado por Token Admin, Token Auditor, Org Admin o Org Auditor. 
public async getOrgAuditors()
Ejemplo de Valor de Devolución:
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "payload": {
            "auditors": [
                {
                    "org_id": "FI1",
                    "user_id": "auditor_user_fi1"
                },
                {
                    "org_id": "FI2",
                    "user_id": "auditor_user_fi2"
                }
            ]
        },
        "encode": "JSON"
    }
}

Ir a métodos de controlador

Los siguientes métodos de controlador admiten las funciones de rol de auditor.
AddTokenAuditor
Este método agrega un usuario como Token Auditor del código de cadenas. Este método solo puede ser llamado por Token Admin del código de cadenas. 
func (t *Controller) AddTokenAuditor(org_id string, user_id string) (interface{}, error)
Parámetros:
  • org_id: string: ID del proveedor de servicios de afiliación (MSP) del usuario en la organización actual.
  • user_id: string: nombre de usuario o ID de correo electrónico del usuario.
Devuelve:
  • Cuando se realiza correctamente, un mensaje que incluye detalles del usuario que se agregó como Token Auditor del código de cadenas.
Ejemplo de Valor de Devolución:
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "f0888dd52f39dfa669275cc8f35d0b47b37b8407d384493d16970fcbb377f937",
        "payload": {
            "msg": "Successfully added Token Auditor (Org_Id: CB, User_Id: cb)"
        },
        "encode": "JSON",
        "sourceURL": "cb-oabcs1-bom.blockchain.ocp.example.com:20010",
        "blockNumber": 268
    }
}
RemoveTokenAuditor
Este método elimina un usuario como Token Auditor del código de cadenas. Este método solo puede ser llamado por Token Admin del código de cadenas. 
func (t *Controller) RemoveTokenAuditor(org_id string, user_id string) (interface{}, error)
Parámetros:
  • org_id: string: ID del proveedor de servicios de afiliación (MSP) del usuario en la organización actual.
  • user_id: string: nombre de usuario o ID de correo electrónico del usuario.
Devuelve:
  • Cuando se realiza correctamente, un mensaje que incluye detalles del usuario que se eliminó como Token Auditor del código de cadenas.
Ejemplo de Valor de Devolución:
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "2f01f48eceaf2dff175f98b96a5bdd22c949f48fc5683ce86d6141cc4892aee3",
        "payload": {
            "msg": "Successfully removed Token Auditor (Org_Id: CB, User_Id: cb)"
        },
        "encode": "JSON",
        "sourceURL": "cb-oabcs1-bom.blockchain.ocp.example.com:20010",
        "blockNumber": 270
    }
}
GetTokenAuditors
Este método devuelve todo Token Auditors del código de cadenas. Este método solo puede ser llamado por Token Admin o Token Auditor del código de cadenas. 
func (t *Controller) GetTokenAuditors() (interface{}, error)
Ejemplo de Valor de Devolución:
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "18eaa81b04d43db64f28287bab1cf6609e2a1d8ff84852ff73849ddb9a9dfba1",
        "payload": {
            "auditors": [
                {
                    "OrgId": "CB",
                    "UserId": "auditor_user_cb"
                }
            ]
        },
        "encode": "JSON",
        "sourceURL": "cb-oabcs1-bom.blockchain.ocp.example.com:20010",
        "blockNumber": 269
    }
}
AddOrgAuditor
Este método agrega un usuario como Org Auditor del código de cadenas. Este método solo puede ser llamado por Token Admin o Org Admin del código de cadenas. 
func (t *Controller) AddOrgAuditor(org_id string, user_id string) (interface{}, error)
Parámetros:
  • org_id: string: ID del proveedor de servicios de afiliación (MSP) del usuario en la organización actual.
  • user_id: string: nombre de usuario o ID de correo electrónico del usuario.
Devuelve:
  • Cuando se realiza correctamente, un mensaje que incluye detalles del usuario que se agregó como Org Auditor del código de cadenas.
Ejemplo de Valor de Devolución:
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "3d5ec46003c68c6208d43c82894bd6da5c0b763339cc5212e09b71d39d0d80e2",
        "payload": {
            "msg": "Successfully added Org Auditor (Org_Id: CB, User_Id: cb)"
        },
        "encode": "JSON",
        "sourceURL": "cb-oabcs1-bom.blockchain.ocp.example.com:20010",
        "blockNumber": 271
    }
}
RemoveOrgAuditor
Este método elimina un usuario como Org Auditor del código de cadenas. Este método solo puede ser llamado por Token Admin o Org Admin del código de cadenas. 
func (t *Controller) RemoveOrgAuditor(org_id string, user_id string) (interface{}, error)
Parámetros:
  • org_id: string: ID del proveedor de servicios de afiliación (MSP) del usuario en la organización actual.
  • user_id: string: nombre de usuario o ID de correo electrónico del usuario.
Devuelve:
  • Cuando se realiza correctamente, un mensaje que incluye detalles del usuario que se eliminó como Org Auditor del código de cadenas.
Ejemplo de Valor de Devolución:
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "713a120641afbc4dfaeac73b82c9fd51df6fcfd7d4d9a82553d3c487bf11f530",
        "payload": {
            "msg": "Successfully removed Org Auditor (Org_Id: CB, User_Id: cb)"
        },
        "encode": "JSON",
        "sourceURL": "cb-oabcs1-bom.blockchain.ocp.example.com:20010",
        "blockNumber": 273
    }
}
GetOrgAuditors
Este método devuelve todo Org Auditors del código de cadenas. Este método solo puede ser llamado por Token Admin, Token Auditor, Org Admin o Org Auditor. 
func (t *Controller) GetOrgAuditors() (interface{}, error)
Ejemplo de Valor de Devolución:
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "07656bf434616d7a3d7fe4fb81dc80c8cc608991648adfd9f6f2f2b9f6ddf468",
        "payload": {
            "auditors": [
                {
                    "OrgId": "CB",
                    "UserId": "cb"
                },
                {
                    "OrgId": "CB",
                    "UserId": "issuer_user_cb"
                }
            ]
        },
        "encode": "JSON",
        "sourceURL": "cb-oabcs1-bom.blockchain.ocp.example.com:20010",
        "blockNumber": 272
    }
}

Métodos de SDK TypeScript

Los siguientes métodos SDK soportan las funciones del rol de auditor.
addTokenAuditor
Este método agrega un usuario como Token Auditor del código de cadenas. 
this.Ctx.Admin.addTokenAuditor(org_id, user_id)
Parámetros:
  • org_id: string: ID del proveedor de servicios de afiliación (MSP) del usuario en la organización actual.
  • user_id: string: nombre de usuario o ID de correo electrónico del usuario.
Devuelve:
  • Cuando se realiza correctamente, un mensaje que incluye detalles del usuario que se agregó como Token Auditor del código de cadenas.
Ejemplo de Valor de Devolución:
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "cd81f6c4c9e7c18ece357dbf5c139ef66ef2d6566be3b14de5f6d0a3fd4bb2f0",
        "payload": {
            "msg": "Successfully added Token Auditor (Org_Id: CB, User_Id: cb)"
        },
        "encode": "JSON",
        "sourceURL": "cb-oabcs1-bom.blockchain.ocp.example.com:20009",
        "blockNumber": 196
    }
}
removeTokenAuditor
Este método elimina un usuario como Token Auditor del código de cadenas. 
this.Ctx.Admin.removeTokenAuditor(org_id, user_id)
Parámetros:
  • org_id: string: ID del proveedor de servicios de afiliación (MSP) del usuario en la organización actual.
  • user_id: string: nombre de usuario o ID de correo electrónico del usuario.
Devuelve:
  • Cuando se realiza correctamente, un mensaje que incluye detalles del usuario que se eliminó como Token Auditor del código de cadenas.
Ejemplo de Valor de Devolución:
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "a886a6040fbc76374a3c78c89ab0ffc9f7b8391cc5239b169bf3b878cf40c67b",
        "payload": {
            "msg": "Successfully removed Token Auditor (Org_Id: CB, User_Id: cb)"
        },
        "encode": "JSON",
        "sourceURL": "cb-oabcs1-bom.blockchain.ocp.example.com:20010",
        "blockNumber": 219
    }
}
getTokenAuditors
Este método devuelve todo Token Auditors del código de cadenas. 
this.Ctx.Admin.getAllTokenAuditors()
Ejemplo de Valor de Devolución:
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "payload": {
            "auditors": [
                {
                    "org_id": "CB",
                    "user_id": "auditor_user_cb"
                }
            ]
        },
        "encode": "JSON"
    }
}
addOrgAuditor
Este método agrega un usuario como Org Auditor del código de cadenas. 
this.Ctx.Admin.addOrgAuditor(org_id, user_id)
Parámetros:
  • org_id: string: ID del proveedor de servicios de afiliación (MSP) del usuario en la organización actual.
  • user_id: string: nombre de usuario o ID de correo electrónico del usuario.
Devuelve:
  • Cuando se realiza correctamente, un mensaje que incluye detalles del usuario que se agregó como Org Auditor del código de cadenas.
Ejemplo de Valor de Devolución:
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "44bbad35a1478cb714e32f7cfd551897868a203520aab9cea5771d3aadc1cf03",
        "payload": {
            "msg": "Successfully added Org Auditor (Org_Id: CB, User_Id: cb)"
        },
        "encode": "JSON",
        "sourceURL": "cb-oabcs1-bom.blockchain.ocp.example.com:20009",
        "blockNumber": 198
    }
}
removeOrgAuditor
Este método elimina un usuario como Org Auditor del código de cadenas. 
this.Ctx.Admin.removeOrgAuditor(org_id, user_id)
Parámetros:
  • org_id: string: ID del proveedor de servicios de afiliación (MSP) del usuario en la organización actual.
  • user_id: string: nombre de usuario o ID de correo electrónico del usuario.
Devuelve:
  • Cuando se realiza correctamente, un mensaje que incluye detalles del usuario que se eliminó como Org Auditor del código de cadenas.
Ejemplo de Valor de Devolución:
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "c3bc720461004a53b37c68d4bb264858b88d980bc093a0a3ebb62a32974fb306",
        "payload": {
            "msg": "Successfully removed Org Auditor (Org_Id: CB, User_Id: cb)"
        },
        "encode": "JSON",
        "sourceURL": "cb-oabcs1-bom.blockchain.ocp.example.com:20010",
        "blockNumber": 221
    }
}
getOrgAuditors
Este método devuelve todo Org Auditors del código de cadenas. 
this.Ctx.Admin.getAllOrgAuditors()
Ejemplo de Valor de Devolución:
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "payload": {
            "auditors": [
                {
                    "org_id": "FI1",
                    "user_id": "auditor_user_fi1"
                },
                {
                    "org_id": "FI2",
                    "user_id": "auditor_user_fi2"
                }
            ]
        },
        "encode": "JSON"
    }
}

Métodos de SDK de Go

Los siguientes métodos de controlador admiten las funciones de rol de auditor.
AddTokenAuditor
Este método agrega un usuario como Token Auditor del código de cadenas. 
t.Ctx.Admin.AddTokenAuditor(org_id, user_id)
Parámetros:
  • org_id: string: ID del proveedor de servicios de afiliación (MSP) del usuario en la organización actual.
  • user_id: string: nombre de usuario o ID de correo electrónico del usuario.
Devuelve:
  • Cuando se realiza correctamente, un mensaje que incluye detalles del usuario que se agregó como Token Auditor del código de cadenas.
Ejemplo de Valor de Devolución:
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "f0888dd52f39dfa669275cc8f35d0b47b37b8407d384493d16970fcbb377f937",
        "payload": {
            "msg": "Successfully added Token Auditor (Org_Id: CB, User_Id: cb)"
        },
        "encode": "JSON",
        "sourceURL": "cb-oabcs1-bom.blockchain.ocp.example.com:20010",
        "blockNumber": 268
    }
}
RemoveTokenAuditor
Este método elimina un usuario como Token Auditor del código de cadenas. 
t.Ctx.Admin.RemoveTokenAuditor(org_id, user_id)
Parámetros:
  • org_id: string: ID del proveedor de servicios de afiliación (MSP) del usuario en la organización actual.
  • user_id: string: nombre de usuario o ID de correo electrónico del usuario.
Devuelve:
  • Cuando se realiza correctamente, un mensaje que incluye detalles del usuario que se eliminó como Token Auditor del código de cadenas.
Ejemplo de Valor de Devolución:
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "2f01f48eceaf2dff175f98b96a5bdd22c949f48fc5683ce86d6141cc4892aee3",
        "payload": {
            "msg": "Successfully removed Token Auditor (Org_Id: CB, User_Id: cb)"
        },
        "encode": "JSON",
        "sourceURL": "cb-oabcs1-bom.blockchain.ocp.example.com:20010",
        "blockNumber": 270
    }
}
GetTokenAuditors
Este método devuelve todo Token Auditors del código de cadenas. 
t.Ctx.Admin.GetAllTokenAuditors()
Ejemplo de Valor de Devolución:
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "18eaa81b04d43db64f28287bab1cf6609e2a1d8ff84852ff73849ddb9a9dfba1",
        "payload": {
            "auditors": [
                {
                    "OrgId": "CB",
                    "UserId": "auditor_user_cb"
                }
            ]
        },
        "encode": "JSON",
        "sourceURL": "cb-oabcs1-bom.blockchain.ocp.example.com:20010",
        "blockNumber": 269
    }
}
AddOrgAuditor
Este método agrega un usuario como Org Auditor del código de cadenas. 
t.Ctx.Admin.AddOrgAuditor(org_id, user_id)
Parámetros:
  • org_id: string: ID del proveedor de servicios de afiliación (MSP) del usuario en la organización actual.
  • user_id: string: nombre de usuario o ID de correo electrónico del usuario.
Devuelve:
  • Cuando se realiza correctamente, un mensaje que incluye detalles del usuario que se agregó como Org Auditor del código de cadenas.
Ejemplo de Valor de Devolución:
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "3d5ec46003c68c6208d43c82894bd6da5c0b763339cc5212e09b71d39d0d80e2",
        "payload": {
            "msg": "Successfully added Org Auditor (Org_Id: CB, User_Id: cb)"
        },
        "encode": "JSON",
        "sourceURL": "cb-oabcs1-bom.blockchain.ocp.example.com:20010",
        "blockNumber": 271
    }
}
RemoveOrgAuditor
Este método elimina un usuario como Org Auditor del código de cadenas. 
t.Ctx.Admin.RemoveOrgAuditor(org_id, user_id)
Parámetros:
  • org_id: string: ID del proveedor de servicios de afiliación (MSP) del usuario en la organización actual.
  • user_id: string: nombre de usuario o ID de correo electrónico del usuario.
Devuelve:
  • Cuando se realiza correctamente, un mensaje que incluye detalles del usuario que se eliminó como Org Auditor del código de cadenas.
Ejemplo de Valor de Devolución:
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "713a120641afbc4dfaeac73b82c9fd51df6fcfd7d4d9a82553d3c487bf11f530",
        "payload": {
            "msg": "Successfully removed Org Auditor (Org_Id: CB, User_Id: cb)"
        },
        "encode": "JSON",
        "sourceURL": "cb-oabcs1-bom.blockchain.ocp.example.com:20010",
        "blockNumber": 273
    }
}
GetOrgAuditors
Este método devuelve todo Org Auditors del código de cadenas. 
t.Ctx.Admin.GetAllOrgAuditors()
Ejemplo de Valor de Devolución:
{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "07656bf434616d7a3d7fe4fb81dc80c8cc608991648adfd9f6f2f2b9f6ddf468",
        "payload": {
            "auditors": [
                {
                    "OrgId": "CB",
                    "UserId": "cb"
                },
                {
                    "OrgId": "CB",
                    "UserId": "issuer_user_cb"
                }
            ]
        },
        "encode": "JSON",
        "sourceURL": "cb-oabcs1-bom.blockchain.ocp.example.com:20010",
        "blockNumber": 272
    }
}