Fonctions de bibliothèque de contrôle d'accès détaillé

Le package de bibliothèque fournit les fonctions suivantes pour les ressources, les groupes et les ACL, ainsi que pour les fonctions globales.

Fonctions globales

Fonction Description
Initialisation (identité *x509). Certificat, stub shim.ChaincodeStubInterface) (erreur) (erreur)

Lorsque le code chaîne est instancié, la fonction d'initialisation est appelée. Cette fonction initialisera l'état du monde avec des listes de contrôle d'accès intégrées. Ces listes intégrées sont utilisées pour initialiser l'environnement. Il doit donc y avoir un contrôle d'accès sur qui peut créer des ressources, des groupes et des listes de contrôle d'accès. Si l'identifiant est nul, utilisez l'identifiant de l'appelant.

Une fois l'opération d'initialisation terminée, les entités suivantes sont créées :

  • Une ressource nommée ". Ressources". Une ACL correspondante nommée ". Resources.ACL sera créé avec un modèle d'identité unique au format"%CN%bob.smith@oracle.com", utilisant le nom commun réel, et l'accès sera CREATE, READ, UPDATE et DELETE.
  • Un groupe nommé ". Groupes". Une ACL correspondante nommée ". Groups.ACL sera créé avec un modèle d'identité unique au format"%CN%bob.smith@oracle.com", utilisant le nom commun réel, et l'accès sera CREATE, READ, UPDATE et DELETE.
  • Une ACL nommée ". ACL. Une liste de contrôle ACL correspondante nommée ". ACLs.ACL sera créé avec un modèle d'identité unique au format"%CN%bob.smith@oracle.com", utilisant le nom commun réel, et l'accès sera CREATE, READ, UPDATE et DELETE.
NewGroupManager(identité *x509). Certificat, stub shim.ChaincodeStubInterface) (*GroupManager, erreur)

Obtenir le gestionnaire de groupe utilisé pour toutes les opérations liées au groupe.

Identité : identité par défaut pour l'opération associée. Si elle est nulle, utilisez l'identité de l'appelant.
NewACLManager(identité *x509). Certificat, stub shim.ChaincodeStubInterface) (*ACLManager, erreur)

Obtenez le gestionnaire d'ACL utilisé pour toutes les opérations liées aux ACL.

Identité : identité par défaut pour l'opération associée. Si elle est nulle, utilisez l'identité de l'appelant.
NewResourceManager(identité *x509). Certificat, stub shim.ChaincodeStubInterface) (*ResourceManager, erreur)

Obtenez le gestionnaire de ressources utilisé pour toutes les opérations liées aux ressources.

Identité : identité par défaut pour l'opération associée. Si elle est nulle, utilisez l'identité de l'appelant.

Fonctions de liste de contrôle d'accès (ACL)

Définition de la structure ACL :
type ACL struct {
  Name string
  Description string
  Accesses []string  // CREATE, READ, UPDATE, and DELETE, or whatever the end-user defined
  Patterns []string    // identities
  Allowed bool          // true means allows access.
  BindACLs []string  // The list of ACL , control who can call the APIs of this struct
}
  • Accès : la chaîne Accès est une liste de noms d'accès arbitraires séparés par des virgules et pouvant aller jusqu'à l'application, à l'exception de quatre : CREATE, READ, UPDATE et DELETE. Ces valeurs d'accès sont utilisées pour maintenir le contrôle d'accès détaillé. Les applications peuvent utiliser leurs propres chaînes d'accès, telles que "register", "invoke" ou "query", ou même l'accès aux noms de champ, tels que "owner", "quantity", etc.
  • Autorisé : Autorisé détermine si les identités correspondant à un modèle sont autorisées à accéder (vrai) ou interdites d'accès (faux). Vous pouvez avoir une liste de contrôle d'accès indiquant que Bob a accès à "CREATE", et une autre indiquant que le groupe Oracle (dont Bob est membre) est interdit à partir de "CREATE". L'accès ou non de Bob dépend de l'ordre des listes de contrôle d'accès associées à l'entité en question.
  • BindACLs : le paramètre BindACLs formera la liste de contrôle d'accès initiale.

Fonctions ACL :

Fonction Description
Créer (ACL ACL, identité *x509). Certificat) (erreur)

Crée une ACL. Les listes de contrôle d'accès nommées en double ne sont pas autorisées.

Pour créer une nouvelle ACL, l'identité doit disposer d'un accès CREATE à la ressource bootstrap nommée ". ACL. Si l'identité est nulle, l'identité par défaut indiquée dans newACLManager() est utilisée.
Get(aclName chaîne, identité *x509. Certificat) (ACL, erreur)

Obtenez une ACL nommée.

L'identité doit avoir un accès en lecture à l'ACL nommée. Si l'identité est nulle, l'identité par défaut indiquée dans newACLManager() est utilisée.
Delete(chaîne aclName, identité *x509. Certificat) (erreur)

Supprimer une ACL spécifiée.

L'identité doit avoir un accès DELETE à l'ACL nommée. Si l'identité est nulle, l'identité par défaut indiquée dans newACLManager() est utilisée.
Update(ACL ACL, identité *x509). Certificat) (erreur)

Mise à jour d'une liste de contrôle d'accès.

L'identité doit disposer de l'accès UPDATE à la ressource nommée et l'ACL nommée doit exister. Si l'identité est nulle, l'identité par défaut indiquée dans NewACLManager() est utilisée.
AddPattern(chaîne aclName, chaîne de modèle, identité *x509. Certificat) (erreur)

Ajoute un nouveau modèle d'identité à l'ACL nommée. L'identité doit disposer de l'accès UPDATE à l'ACL nommée.

Si l'identité est nulle, l'identité par défaut indiquée dans newACLManager() est utilisée.
RemovePattern(chaîne aclName, chaîne de modèle, identité *X509Certificate) (erreur)

Supprime le modèle d'identité de l'ACL. L'identité doit disposer de l'accès UPDATE à l'ACL nommée.

Si l'identité est nulle, l'identité par défaut indiquée dans newACLManager() est utilisée.
AddAccess(chaîne aclname, chaîne d'accès, identité *X509Certificate) (erreur)

Ajoute un nouvel accès à l'ACL nommée. L'identité doit disposer de l'accès UPDATE à l'ACL nommée.

Si l'identité est nulle, l'identité par défaut indiquée dans newACLManager() est utilisée.
RemoveAccess(chaîne aclName, chaîne d'accès, identité *X509Certificate) (erreur)

Supprime l'accès de l'ACL. L'identité doit disposer de l'accès UPDATE à l'ACL nommée.

Si l'identité est nulle, l'identité par défaut indiquée dans newACLManager() est utilisée.
UpdateDescription(chaîne aclName, chaîne newDescription, identité *X509Certificate) (erreur)

Mettez à jour la description.

L'identité doit disposer de l'accès UPDATE à l'ACL nommée. Si l'identité est nulle, l'identité par défaut indiquée dans newACLManager() est utilisée.
AddBeforeACL(chaîne aclName, chaîne beforeName, chaîne newBindACL, identité *X509Certificate) (erreur)

Ajoute une ACL attachée avant l'ACL nommée existante. Si l'ACL nommée est vide ou introuvable, l'ACL est ajoutée au début de la liste d'ACL de liaison.

L'identité doit disposer de l'accès UPDATE à l'ACL nommée. Si l'identité est nulle, l'identité par défaut indiquée dans newACLManager() est utilisée.
AddAfterACL(chaîne aclName, chaîne afterName, chaîne newBindACL, identité *X509Certificate) (erreur)

Ajoute une ACL attachée après l'ACL nommée existante. Si l'ACL nommée est vide ou introuvable, l'ACL est ajoutée à la fin de la liste d'ACL de liaison.

L'identité doit disposer de l'accès UPDATE à l'ACL nommée. Si l'identité est nulle, l'identité par défaut indiquée dans newACLManager() est utilisée.
RemoveBindACL(chaîne aclName, chaîne removeName, identité *X509Certificate) (erreur)

Supprime l'ACL removeName de la liste d'ACL de liaison.

L'identité doit disposer de l'accès UPDATE à l'ACL nommée. Si l'identité est nulle, l'identité par défaut indiquée dans newACLManager() est utilisée.
GetAll(identité *x509). Certificat) ([]ACL, erreur)

Obtenez toutes les ACL.

L'identité doit avoir un accès en lecture à l'ACL nommée. Si l'identité est nulle, l'identité par défaut indiquée dans newACLManager() est utilisée.

Fonctions de groupe

Définition de la structure Group :
type Group struct {
    Name string
    Description string
    Members []string     // identity patterns, except GRP.
    BindACLs []string    // The list of ACLs, controls who can access this group.
}

Définition des fonctions GroupManager :

Fonction Description
Create(groupe de groupes, identité *x509. Certificat) (erreur)

Créez un groupe.

L'identité doit avoir un accès CREATE au groupe bootstrap ". Groupe". Si l'identité est nulle, l'identité par défaut indiquée dans NewGroupManager() est utilisée.
Get(groupName chaîne, identité *x509. Certificat) (Groupe, erreur)

Obtention d'un groupe spécifié.

L'identité doit avoir un accès en lecture à ce groupe. Si l'identité est nulle, l'identité par défaut indiquée dans NewGroupManager() est utilisée.
Delete(chaîne groupName, identité *x509. Certificat) (erreur)

Supprimer un groupe spécifié

L'identité doit avoir un accès DELETE à ce groupe. Si l'identité est nulle, l'identité par défaut indiquée dans NewGroupManager () est utilisée.
AddMembers(chaîne groupName, chaîne de membre []string, identité *x509. Certificat) (erreur)

Ajoutez des membres au groupe.

L'identité doit avoir un accès UPDATE à ce groupe. Si l'identité est nulle, l'identité par défaut indiquée dans NewGroupManager () est utilisée.
RemoveMembers(chaîne groupName, chaîne de membre []string, identité *x509. Certificat) (erreur)

Enlevez un ou plusieurs membres d'un groupe.

L'identité doit avoir un accès UPDATE à ce groupe. Si l'identité est nulle, l'identité par défaut indiquée dans NewGroupManager () est utilisée.
UpdateDescription(chaîne groupName, chaîne newDes, identité *x509. Certificat) (erreur)

Mettez à jour la description.

L'identité doit avoir un accès UPDATE à ce groupe. Si l'identité est nulle, l'identité par défaut indiquée dans NewGroupManager () est utilisée.
AddBeforeACL(chaîne groupName, chaîne beforeName, chaîne aclName, identité *x509. Certificat) (erreur)

Ajoute une ACL attachée au groupe avant l'ACL nommée existante. Si l'ACL nommée est vide ou introuvable, l'ACL est ajoutée au début de la liste d'ACL de liaison de la ressource.

L'identité doit disposer d'un accès UPDATE au groupe nommé. Si l'identité est nulle, l'identité par défaut indiquée dans NewGroupManager () est utilisée.
AddAfterACL(chaîne groupName, chaîne afterName, chaîne aclName, identité *x509. Certificat) (erreur)

Ajoute une ACL attachée au groupe après l'ACL nommée existante. Si l'ACL nommée est vide ou introuvable, l'ACL est ajoutée à la fin de la liste d'ACL de liaison du groupe.

L'identité doit disposer d'un accès UPDATE au groupe nommé. Si l'identité est nulle, l'identité par défaut indiquée dans NewGroupManager () est utilisée.
RemoveBindACL(chaîne groupName, chaîne aclName, identité *x509. Certificat) (erreur)

Supprime l'ACL nommée de la liste d'ACL attachée du groupe nommé.

L'identité doit disposer d'un accès UPDATE au groupe nommé. Si l'identité est nulle, l'identité par défaut indiquée dans NewGroupManager () est utilisée.
GetAll(identité *x509). Certificat) ([]Groupe, erreur)

Obtenir tous les groupes.

L'identité doit avoir un accès en lecture à ces groupes. Si l'identité est nulle, l'identité par défaut indiquée dans NewGroupManager () est utilisée.

Fonctions de ressource

Définition de la structure Resource :
type Resource struct {
     Name string
     Description string
     BindACLs []string      // The name list of ACL, controls who can access this resource
}

Fonctions de ressource :

Fuite Description
Créer (ressource de ressource, identité *x509). Certificat) (erreur)

Créer une ressource. Les ressources nommées en double ne sont pas autorisées.

L'identité doit avoir un accès CREATE à la ressource bootstrap nommée ". Ressources" Si l'identité est NULL, l'identité par défaut indiquée dans NewResourceManager() est utilisée.
Get(resName chaîne, identité *x509. Certificat) (Ressource, erreur)

Obtenir une ressource spécifiée.

L'identité doit avoir un accès en lecture à la ressource. Si l'identité est NULL, l'identité par défaut indiquée dans NewResourceManager() est utilisée.
Delete(chaîne resName, identité *x509. Certificat) (erreur)

Supprimez une ressource nommée.

L'identité doit disposer de l'accès DELETE à la ressource nommée. Si l'identité est NULL, l'identité par défaut indiquée dans NewResourceManager() est utilisée.
UpdateDescription(chaîne resourceName, chaîne newDes, identité *x509. Certificat) (erreur)

Mettez à jour la description.

L'identité doit disposer de l'accès UPDATE à cette ressource. Si l'identité est nulle, l'identité par défaut indiquée dans NewResourceManager() est utilisée.
AddBeforeACL(chaîne resourceName, chaîne beforeName, chaîne aclName, identité *x509. Certificat) (erreur)

Ajoute une ACL de liaison à la ressource avant l'ACL nommée existante. Si l'ACL nommée est vide ou introuvable, l'ACL est ajoutée au début de la liste d'ACL de liaison de la ressource.

L'identité doit disposer d'un accès UPDATE à la ressource nommée. Si l'identité est nulle, l'identité par défaut indiquée dans NewResourceManager() est utilisée.
AddAfterACL(chaîne resourceName, chaîne afterName, chaîne aclName, identité *x509. Certificat) (erreur)

Ajoute une ACL de liaison à la ressource après l'ACL nommée existante. Si l'ACL nommée est vide ou introuvable, l'ACL est ajoutée à la fin de la liste d'ACL de liaison pour la ressource.

L'identité doit disposer d'un accès UPDATE à la ressource nommée. Si l'identité est nulle, l'identité par défaut indiquée dans NewResourceManager() est utilisée.
RemoveBindACL(chaîne resourceName, chaîne aclName, identité *x509. Certificat) (erreur)

Supprime l'ACL nommée de la liste d'ACL attachée de la ressource nommée.

L'identité doit disposer d'un accès UPDATE à la ressource nommée. Si l'identité est nulle, l'identité par défaut indiquée dans NewResourceManager() est utilisée.
CheckAccess(chaîne resName, chaîne d'accès, identité *x509. Certificat) (bool, erreur)

Vérifiez si l'utilisateur actuel dispose de l'accès spécifié à la ressource nommée.

Si l'identité est nulle, l'identité par défaut indiquée dans NewResourceManager() est utilisée.
GetAll(identité *x509). Certificat) ([]Ressource, erreur)

Obtenez toutes les ressources.

L'identité doit avoir un accès en lecture à ces ressources. Si l'identité est nulle, l'identité par défaut indiquée dans NewResourceManager() est utilisée.