13.3.1. authorizationΒΆ

Auth token validator types

AuthorizationStatus:string
Authorization Status enum
enum:
- Accepted
- Blocked
- ConcurrentTx
- Expired
- Invalid
- NoCredit
- NotAllowedTypeEVSE
- NotAtThisLocation
- NotAtThisTime
- Unknown
CertificateStatus:string
Certificate status information
enum:
- Accepted
- SignatureError
- CertificateExpired
- CertificateRevoked
- NoCertificateAvailable
- CertChainError
- ContractCancelled
TokenValidationStatus:string
Ongoing token validation status
enum:
- Processing
- Accepted
- Rejected
- TimedOut
CustomIdToken:object
Type for a custom id token with a free-form type
properties:
value:string <required>
Arbitrary value of the IdToken
type:string <required>
Custom type of the token
IdToken:object
Type for an id token
properties:
value:string <required>
Arbitrary value of the IdToken: This has to be printable case insensitive ascii
type:string <required> (authorization-IdTokenType)
Type of the token
There is an extended definition for this object here.
additional_info:array <optional>
A list of additional custom id tokens than can be used for providing additional information for validation
array_item:object (authorization-CustomIdToken)

There is an extended definition for this object here.

ProvidedIdToken:object
Type for IdToken provided by auth token providers. Contains additional information about the IdToken like the source and purpose
properties:
request_id:integer <optional>
Id of the authorization request of this token. Could be used to put remoteStartId of OCPP2.0.1
id_token:object <required> (authorization-IdToken)
IdToken of the provided token
There is an extended definition for this object here.
parent_id_token:object <optional> (authorization-IdToken)
Parent IdToken of the provided token
There is an extended definition for this object here.
authorization_type:string <required> (authorization-AuthorizationType)
Authorization type of the token.
There is an extended definition for this object here.
connectors:array <optional>
A list of connector ids to which the authorization can be assigned
array_item:integer


prevalidated:boolean <optional>
Indicates that the id token is already validated by the provider
certificate:string <optional>
The X.509 certificated presented by EV and encoded in PEM format
iso15118CertificateHashData:array <optional>
Contains the information needed to verify the EV Contract Certificate via OCSP
array_item:object (iso15118_charger-CertificateHashDataInfo)
An array of contract certificate infos
There is an extended definition for this object here.

TokenValidationStatusMessage:object
The token validation status
properties:
token:object <required> (authorization-ProvidedIdToken)
The id tag assigned to this transaction
There is an extended definition for this object here.
status:string <required> (authorization-TokenValidationStatus)

There is an extended definition for this object here.
messages:array <optional>

array_item:object (display_message-MessageContent)

There is an extended definition for this object here.

ValidationResult:object
Result object containing authorization status enum value and an optional parentIdTag
properties:
authorization_status:string <required> (authorization-AuthorizationStatus)

There is an extended definition for this object here.
certificate_status:string <optional> (authorization-CertificateStatus)

There is an extended definition for this object here.
reason:object <optional> (authorization-TokenValidationStatusMessage)

There is an extended definition for this object here.
expiry_time:string <optional>
Absolute UTC time point when reservation expires in RFC3339 format
format:date-time
parent_id_token:object <optional> (authorization-IdToken)
Parent Id Tag of the validated token
There is an extended definition for this object here.
evse_ids:array <optional>
Only used when the id token is valid for one or more specific evses, not for the whole charging station. Indicates for which evse ids the provided token is valid
array_item:integer


reservation_id:integer <optional>
The reservation id that is used with this validated token.
SelectionAlgorithm:string
The selection algorithm defines the logic to select one connector for an incoming token.
SelectionAlgorithm enum:
UserInput: This algorithm waits for a user to input for which connector the authorization is provided
PlugEvents: This algorithms derives the selected connector based on the order of plug in events of EVs
FindFirst: This algorithm chooses the first referenced EVSE that is available
enum:
- UserInput
- PlugEvents
- FindFirst
AuthorizationType:string
Type of authorization of the provided token. The value of AuthorizationType can influence the authorization process
enum:
- OCPP
- RFID
- Autocharge
- PlugAndCharge
- BankCard
IdTokenType:string
IdTokenType of the provided token. Required by OCPP2.0.1 to distinguish between different types of tokens.
enum:
- Central
- eMAID
- MacAddress
- ISO14443
- ISO15693
- KeyCode
- Local
- NoAuthorization