ResultData

Kotlin |Java

abstract class ResultData

kotlin.Any
↳	androidx.security.identity.ResultData

An object that contains the result of retrieving data from a credential. This is used to return data requested from a IdentityCredential.

Summary

Constants
static Int	STATUS_NOT_IN_REQUEST_MESSAGE Requested entry wasn't in the request message.
static Int	STATUS_NOT_REQUESTED Requested entry was not requested.
static Int	STATUS_NO_ACCESS_CONTROL_PROFILES The requested entry was not retrieved because it was configured without any access control profile.
static Int	STATUS_NO_SUCH_ENTRY Requested entry does not exist.
static Int	STATUS_OK Value was successfully retrieved.
static Int	STATUS_READER_AUTHENTICATION_FAILED The requested entry was not retrieved because reader authentication wasn't performed.
static Int	STATUS_USER_AUTHENTICATION_FAILED The requested entry was not retrieved because user authentication wasn't performed.

Public methods
abstract ByteArray	getAuthenticatedData() Returns a CBOR structure containing the retrieved data.
abstract ByteArray?	getEcdsaSignature() Returns a digital signature over the DeviceAuthenticationBytes CBOR specified in getAuthenticatedData(), to prove to the reader that the data is from a trusted credential.
abstract ByteArray?	getEntry(@NonNull namespaceName: String, @NonNull name: String) Gets the raw CBOR data for the value of an entry.
open Boolean	getEntryBoolean(@NonNull namespaceName: String, @NonNull name: String) Gets the value of an entry.
open ByteArray?	getEntryBytestring(@NonNull namespaceName: String, @NonNull name: String) Gets the value of an entry.
open Calendar?	getEntryCalendar(@NonNull namespaceName: String, @NonNull name: String) Gets the value of an entry.
open Long	getEntryInteger(@NonNull namespaceName: String, @NonNull name: String) Gets the value of an entry.
abstract MutableCollection<String!>?	getEntryNames(@NonNull namespaceName: String) Get the names of all entries.
open String?	getEntryString(@NonNull namespaceName: String, @NonNull name: String) Gets the value of an entry.
abstract ByteArray?	getMessageAuthenticationCode() Returns a message authentication code over the DeviceAuthenticationBytes CBOR specified in getAuthenticatedData(), to prove to the reader that the data is from a trusted credential.
abstract MutableCollection<String!>	getNamespaces() Gets the names of namespaces with retrieved entries.
abstract MutableCollection<String!>?	getRetrievedEntryNames(@NonNull namespaceName: String) Get the names of all entries that was successfully retrieved.
abstract ByteArray	getStaticAuthenticationData() Returns the static authentication data associated with the dynamic authentication key used to sign or MAC the data returned by getAuthenticatedData().
abstract Int	getStatus(@NonNull namespaceName: String, @NonNull name: String) Gets the status of an entry.

Constants

STATUS_NOT_IN_REQUEST_MESSAGE

static val STATUS_NOT_IN_REQUEST_MESSAGE: Int

Requested entry wasn't in the request message.

Value: 3

STATUS_NOT_REQUESTED

static val STATUS_NOT_REQUESTED: Int

Requested entry was not requested.

Value: 2

STATUS_NO_ACCESS_CONTROL_PROFILES

static val STATUS_NO_ACCESS_CONTROL_PROFILES: Int

The requested entry was not retrieved because it was configured without any access control profile.

Value: 6

STATUS_NO_SUCH_ENTRY

static val STATUS_NO_SUCH_ENTRY: Int

Requested entry does not exist.

Value: 1

STATUS_OK

static val STATUS_OK: Int

Value was successfully retrieved.

Value: 0

STATUS_READER_AUTHENTICATION_FAILED

static val STATUS_READER_AUTHENTICATION_FAILED: Int

The requested entry was not retrieved because reader authentication wasn't performed.

Value: 5

STATUS_USER_AUTHENTICATION_FAILED

static val STATUS_USER_AUTHENTICATION_FAILED: Int

The requested entry was not retrieved because user authentication wasn't performed.

Value: 4

Public methods

getAuthenticatedData

@NonNull abstract fun getAuthenticatedData(): ByteArray

Returns a CBOR structure containing the retrieved data.

This structure - along with the session transcript - may be cryptographically authenticated to prove to the reader that the data is from a trusted credential and getMessageAuthenticationCode() can be used to get a MAC.

The CBOR structure which is cryptographically authenticated is the DeviceAuthenticationBytes structure according to the following CDDL schema:

DeviceAuthentication = [
          "DeviceAuthentication",
          SessionTranscript,
          DocType,
          DeviceNameSpacesBytes
        ]
     
        DocType = tstr
        SessionTranscript = any
        DeviceNameSpacesBytes = #6.24(bstr .cbor DeviceNameSpaces)
        DeviceAuthenticationBytes = #6.24(bstr .cbor DeviceAuthentication)
      

where

DeviceNameSpaces = {
          * NameSpace => DeviceSignedItems
        }
     
        DeviceSignedItems = {
          + DataItemName => DataItemValue
        }
     
        NameSpace = tstr
        DataItemName = tstr
        DataItemValue = any
      

The returned data is the binary encoding of the DeviceNameSpaces structure as defined above.

Return
ByteArray	The bytes of the DeviceNameSpaces CBOR structure.

getEcdsaSignature

@Nullable abstract fun getEcdsaSignature(): ByteArray?

Returns a digital signature over the DeviceAuthenticationBytes CBOR specified in getAuthenticatedData(), to prove to the reader that the data is from a trusted credential. The signature will be made with one of the provisioned dynamic authentication keys. At most one of getMessageAuthenticationCode() or getEcdsaSignature() is implemented.

Return
ByteArray?	null if not implemented, otherwise a COSE_Sign1 structure with the payload set to the data returned by getAuthenticatedData().

getEntry

@Nullable abstract fun getEntry(
    @NonNull namespaceName: String, 
    @NonNull name: String
): ByteArray?

Gets the raw CBOR data for the value of an entry. This should only be called on an entry for which the getStatus(String, String) method returns STATUS_OK.

Parameters
namespaceName	String: the namespace name of the entry.
name	String: the name of the entry to get the value for.

Return
ByteArray?	the raw CBOR data or null if no entry with the given name exists.

getEntryBoolean

open fun getEntryBoolean(
    @NonNull namespaceName: String, 
    @NonNull name: String
): Boolean

Gets the value of an entry. This should only be called on an entry for which the getStatus(String, String) method returns STATUS_OK.

Parameters
namespaceName	String: the namespace name of the entry.
name	String: the name of the entry to get the value for.

Return
Boolean	a boolean or false if no entry with the given name exists.

getEntryBytestring

@Nullable open fun getEntryBytestring(
    @NonNull namespaceName: String, 
    @NonNull name: String
): ByteArray?

Gets the value of an entry. This should only be called on an entry for which the getStatus(String, String) method returns STATUS_OK.

Parameters
namespaceName	String: the namespace name of the entry.
name	String: the name of the entry to get the value for.

Return
ByteArray?	a byte[] or null if no entry with the given name exists.

getEntryCalendar

@Nullable open fun getEntryCalendar(
    @NonNull namespaceName: String, 
    @NonNull name: String
): Calendar?

Gets the value of an entry. This should only be called on an entry for which the getStatus(String, String) method returns STATUS_OK.

Parameters
namespaceName	String: the namespace name of the entry.
name	String: the name of the entry to get the value for.

Return
Calendar?	a Calendar or null if no entry with the given name exists.

getEntryInteger

open fun getEntryInteger(
    @NonNull namespaceName: String, 
    @NonNull name: String
): Long

Gets the value of an entry. This should only be called on an entry for which the getStatus(String, String) method returns STATUS_OK.

Parameters
namespaceName