<- Go to ProcessActions  ->

1 Definition 2 Protocol 3 Syntax 4 Semantics

1 Definition

The Action of a Process requesting an Identity Manage Service to:

  1. Produce an Item from Data, Qualifier, and requested Rights (Status=Model).
  2. Grant Rights (Status=Final) to the Item based on requested Rights .

If the request is accepted, the Item Manage Service responds with Item ID and the requested Rights.

2 Protocol

  1. Process sends “Identify PA Request including Data, Qualifier, Process ID, and Rights (Status=Model)” to Identify Service.
    1. If Identify Service is a free service, goto Identify.
    2. If Identify Service is a pay service:
      1. Process sends “Identify PA Request including Service Pricing Model (Status=Model)” to Identify Service.
      2. Identity Service sends “Identify PA Response” to Process:
        1. If “Identify PA Response includes Status=Err”, goto End.
        2. If “Identify PA Response includes Status=Ack and Service Pricing Model with Transaction (both Status=Model)”, Process:
          1. Transacts “Value included in Transaction”.
          2. Sends to Identify Service “Identify PA Request including Service Pricing Model (Status=Model) with Transaction (Status=Final)”.
  2. Identify: Identify Service
    1. Identifies “Item”.
    2. Sends to User “Identify PA Response” including
      1. “Item ID and Rights (Status=Final)”
      2. “Service Pricing Model (Status=Final)”, if Identify is a pay service.
  3. End.

The protocol described using Workflow Description Language (WDL) is available at this link:

https://schemas.mpai.community/MMM4/V2.2/wdl/IdentifyPA.wdl

3 Syntax

The structure of the input and output messages, using JavaScript Object Notation (JSON)  is available at this link:

https://schemas.mpai.community/MMM4/V2.2/data/IdentifyPA.json

4 Semantics

Label Description
Header Identify Process Action Header – Standard “MMM-IDF-Vx.y”
MInstanceID Identifier of M-Instance.
UEnvironmentID Identifier of U-Environment.
MMSendPAID Identifier of this PA Instance.
MMSendPATime Creation time of this PA Instance.
MMSendPAData Data included in this PA Instance.
– Time Time of PA Request emission and Time of PA Request execution, or PA Response emission.
– RQ-Complements Complements in the PA Requests.
  – Nil Data Data to be Identified.
  – With Qualifier Qualifier of Data.
  – With ModelRights Requested Rights to the Identify Item.
  – At ProcessID
 Process holding Data to be Identified.
  – With SPM Service Pricing Model, if Identify is a pay service.
– RS-Complements Complements in the Response Item.
  – Nil ItemID Item produced.
  – With Rights Rights (Status=Final) based on requested Rights if PA Request is accepted.
  – With PAStatus Possible Error Messages.
    – Ack If PA Request could be performed
    – Err If Error was found
      – FaultyPA Faulty PA Request.
      – IncDQ Incorrect Data and/or Qualifier.
      – InsRights Insufficient Rights.
      – InsValue Insufficient Value in Wallet.
DataXMData Identity, provenance, authorised usage, source, type, governance context, security, legality, and annotation of exchanged data.
 DescMetadata Descriptive Metadata.

<- Go to ProcessActions  ->