Skip to main content

ID Austria attributes in OIDC

This page displays the user attributes available for ID Austria with OpenID Connect (OIDC).

Attributes table​

OIDC claims define the properties to retrieve personal information of you end-users. To request OIDC claims in ID Austria, you can use a combination of these scopes in your requests:

OIDC scopes available for ID Austria

openid (always required for OIDC), profile, idp-id, nin, address, age-verification, nationality, marital-status, idaustria-extra.

OIDC scope configuration

Scopes encode what personal information you request from your end-users.

When requesting scopes for your OIDC client, note that the claims you receive are limited by the settings in your ID Austria service provider. The claims must already be present and approved in your service provider's configuration in Mein USP.

ID Austria provides the following data:

Examples​

When you integrate using OIDC, you specify the scopes in your authentication request. After the end-user successfully authenticates with ID Austria, you can retrieve the claims in the ID Token or through the UserInfo endpoint.

Below, you find examples of requests and responses exchanged as part of an authentication transaction.

Request example​

To start an authentication, your OIDC request may look similar to:

https://<YOUR_SIGNICAT_DOMAIN>/auth/open/connect/authorize?
    &client_id=<OIDC_CLIENT_ID>
    &response_type=code
    &redirect_uri=<REDIRECT_URI>
    &state=xyz123
    &scope=openid%20profile%20nin%20address%20age-verification%20nationality%20marital-status%20idp-id%20idaustria-extra
    &acr_values=idp:idaustria%20idaustria_service_id:<YOUR_SERVICE_UUID>
    &prompt=login
    &code_challenge=Qr_Nb...NFylI
    &code_challenge_method=S256

Note the following request parameters shown in the example above:

  • scope: Specifies the set of claims that your application is requesting from ID Austria.
  • acr_values: Authentication Context Class Reference (ACR) values determine the type or level of authentication required. For ID Austria, the following values are supported:
    • idp:idaustria: Routes the end-user to ID Austria thus skipping the eID selection screen. This applies when you have multiple eIDs active in the Signicat Dashboard and want to automatically route end-users to the ID Austria login screen.
    • idaustria_service_id:<YOUR_SERVICE_UUID>: Specifies the unique identifier (UUID) of the ID Austria service to use for this specific authentication request. This allows you to specify a different service on a per-request basis without changing the default configuration in your Signicat Dashboard.
What happens next?

After you start an authentication and route the user to the authentication URL, the following happens:

  1. The end-user is redirected to ID Austria login page for authentication.
  2. The end-user logs in with their credentials and agrees to share their personal data with you.
  3. After successful authentication, you can retrieve the authorization code at the redirect_uri.
  4. You exchange the authorization code for an ID token and an access token.

Response example​

Below, you find an example of a response obtained from an identity verification flow with ID Austria.

Scopes in request: openid, profile, idp-id, nin, address, age-verification, nationality, marital-status, idaustria-extra.

Example of ID token in response:

{
    "iss":"https://<ACCOUNT_DOMAIN>/auth/open",
    "nbf":1726046529,
    "iat":1726046529,
    "exp":1726047129,
    "aud":"<OIDC_CLIENT_ID>",
    "amr":[
        "external"
    ],
    "at_hash":"_T539pqKJTOovx1xVyMnKA",
    "sid":"783EFB56CEE40C1FA95F0543535B6E4E",
    "sub":"X-FUmG7SkaAb8fA-7IU0ZrpTIJ37fnaV-c5SbXAoOqw=",
    "auth_time":1726046523,
    "idp":"idaustria",
    "idp_id":"3Q3OY2NSWIBHJVGY7E2CHYFKS22Y7YKI",
    "sandbox":true
}
ID Token

The ID Token is configured by default to return only the claims defined in the OIDC standard (standard scopes).

To control the data returned in the ID Token, go to your OIDC client configuration in the Signicat Dashboard, select your OIDC client, navigate to the Advanced > Security tab and edit the ID Token User data field to return All claims.

Example of a response from the UserInfo endpoint:

{
    "idp_id": "4JOF6N3LEVMLZXSA3OV344AVRTJPC5O7",
    "name": "XXXClaus - Maria XXXvon Brandenburg",
    "family_name": "XXXvon Brandenburg",
    "given_name": "XXXClaus - Maria",
    "picture": "/9j/4AAQSkZJRgAB...AQEBLAEsAAD/4gxAAAD/2Q==",
    "gender": "M",
    "birthdate": "1994-12-31",
    "nin": "XERSB+9110037664968:0BVUPZVc5EARCIWgvt2xNXXGjOc=",
    "nin_type": "PERSON",
    "nin_issuing_country": "AT",
    "address":
    {
        "formatted": "Testgasse, 1a-2b, Testort A, 0088",
        "street_address": "Testgasse 1a-2b",
        "street": "Testgasse",
        "house_number": "1a-2b",
        "locality": "Testort A",
        "postal_code": "0088",
        "country": "AT"
    },
    "nationality": "[\"AUT\",\"DEU\",\"CHE\"]",
    "marital_status": "verheiratet",
    "idaustria_country_of_exhibition": "AT",
    "idaustria_authentication_level": "http://eidas.europa.eu/LoA/high",
    "idaustria_level": "urn:eidgvat:eid.status.full",
    "idaustria_type_of_identity": "http://eid.gv.at/eID/status/testidentity",
    "idaustria_bpk_area": "urn:publicid:gv.at:wbpk+XERSB+9110037664968",
    "idaustria_url_citizen_card_environment": "https://hs-abnahme.a-trust.at/securitylayer2",
    "idaustria_signature_certificate": "MIIFdj.../vw==",
    "idaustria_signature": "/9j/4AAQS...kZJRgABA",
    "idaustria_health_service_providers": "eyJn...9fX0=",
    "idaustria_current_photo_capture_date": "2024-02-03",
    "idaustria_reported_since": "2020-02-05",
    "idaustria_identification_document_data": "{\"dokumentTyp\":\"Personalausweis\",\"dokumentNummer\":\"999991010\",\"gueltigVonDatum\":\"2024-02-03\",\"gueltigBisDatum\":\"2034-02-02\",\"akademischerPrefix\":\"DI Dr. Mag.\",\"vorName\":\"XXXVON BRANDENBURG\",\"nachNameZeile1\":\"XXXCLAUS - MARIA\",\"akademischerPostfix\":\"bsca\",\"geschlecht\":\"M\",\"geburtsDatum\":\"1994-12-31\",\"geburtsOrt\":\"WIEN\",\"groesse\":\"166\",\"staat\":\"AUT\",\"ausstellendeBehoerdeZeile1\":\"BMI\",\"ausstellendeBehoerdeZeile2\":\"IV/9\",\"lichtbild\":\"/9j/4AAQSk...EhERE\",\"unterschrift\":\"/9j/4AAQ...SkZJRg\"}",
    "idaustria_id_card_data": "{\"dokumentNummer\":\"999991010\",\"gueltigVonDatum\":\"2024-02-03\",\"gueltigBisDatum\":\"2034-02-02\",\"akademischerPrefix\":\"DI Dr. Mag.\",\"vorName\":\"XXXVON BRANDENBURG\",\"nachNameZeile1\":\"XXXCLAUS - MARIA\",\"akademischerPostfix\":\"bsca\",\"geschlecht\":\"M\",\"geburtsDatum\":\"1994-12-31\",\"geburtsOrt\":\"WIEN\",\"groesse\":\"166\",\"staat\":\"AUT\",\"ausstellendeBehoerdeZeile1\":\"BMI\",\"ausstellendeBehoerdeZeile2\":\"IV/9\",\"lichtbild\":\"/9j/4AA...4hf\",\"unterschrift\":\"/9j/4AAQ...SkZJRg\"}",
    "idaustria_passport_data": "{\"dokumentTyp\":\"Reisepass\",\"dokumentNummer\":\"AP9991012\",\"gueltigVonDatum\":\"2024-02-03\",\"gueltigBisDatum\":\"2034-02-02\",\"akademischerPrefix\":\"DI Dr. Mag.\",\"vorName\":\"XXXVON BRANDENBURG\",\"nachNameZeile1\":\"XXXCLAUS MARIA\",\"akademischerPostfix\":\"bsca\",\"geschlecht\":\"M\",\"geburtsDatum\":\"1994-12-31\",\"geburtsOrt\":\"WIEN\",\"groesse\":\"166\",\"staat\":\"AUT\",\"ausstellendeBehoerdeZeile1\":\"BMI\",\"ausstellendeBehoerdeZeile2\":\"IV/9\",\"lichtbild\":\"/9j/4AAQSk...RgABAgEB\",\"unterschrift\":\"/9j/4AAQ...SkZJRg\"}",
    "idaustria_other_active_residences": "[{\n\"Gemeindekennziffer\":\"09977\",\n\"Gemeindebezeichnung\":\"Testgemeinde 09977 mit maximaler Länge\",\n\"Postleitzahl\":\"0077\",\n\"Ortschaft\":\"Testort 77 mit maximalmöglichen Längen\",\n\"Strasse\":\"Teststraße 77 mit maxi. möglicher Länge von 46\",\n\"Hausnummer\":\"GNR .123/45\",\n\"Stiege\":\"Kirche\",\n\"Tuer\":\"\",\n\"GemeldetVon\":\"2023-08-08\"\n},{\n\"Gemeindekennziffer\":\"90001\",\n\"Gemeindebezeichnung\":\"Wien\",\n\"Postleitzahl\":\"1030\",\n\"Ortschaft\":\"Wien,Landstraße\",\n\"Strasse\":\"Alice-und-Heinrich-Scheuer-Hof\",\n\"Hausnummer\":\"GNR 905/1\",\n\"Stiege\":\"Stg. 1\",\n\"Tuer\":\"1\",\n\"GemeldetVon\":\"2024-04-12\"\n}]\n",
    "idaustria_vehicle_registrations": "{\"attributstatus\":\"OK\",\"attributdaten\":[{\"zulassungsBesitzer\":[{\"geburtsdatum\":\"1994-12-31\",\"name\":\"XXXvon Brandenburg\",\"vorname\":\"XXXClaus - Maria\",\"anschrift\":\"Fahrenbachstraße 45\\n8451 Unterfahrenbach\\nÖsterreich\",\"zustellBevollmaechtigt\":true}],\"kennzeichen\":\"XU-EI0002\",\"zustaendigeBehoerde\":\"BM für Inneres\",\"verwendungsbestimmung\":\"01 - zu keiner besonderen Verwendung bestimmt\",\"genehmigungsgrundlage\":\"EG-Betriebserlaubnis\",\"datumDerGenehmigung\":\"2023-09-22\",\"nationalerCode\":\"207334\",\"aufbau\":\"Schräghecklimousine\",\"hoechsteZulaessigeStuetzlast\":75.0,\"raederBereifung\":\"Achse1+2:205/60R16-92V;6.5Jx16/ET50\\nAchse1+2:215/45R18-89W;7Jx18/ET50\",\"begutachtungsplakette\":\"weiß\",\"auflagenTeilbescheide\":[],\"vermerke\":\"\",\"datumDerErstmaligenZulassung\":\"2023-06-11\",\"antragsteller\":\"Besitzer\",\"letzteZulassungsstelleCode\":\"4101604\",\"letzteZulassungsstelle\":\"Oberösterreichische Kundenbüro Traun\",\"marke\":\"Mazda\",\"typVarianteVersion\":\"BL/545/61W0\",\"handelsbezeichnung\":\"MAZDA3/SP/G100/AZUMA\",\"fahrzeugIdentifizierungsnummer\":\"TESTVIN1380003102\",\"technischZulaessigeGesamtmasse\":1800.0,\"hoechstesZulaessigesGesamtgewicht\":1800.0,\"eigengewicht\":1190.0,\"datumDerZulassung\":\"2023-07-26\",\"fahrzeugklasseFahrzeugart\":\"M1/Personenkraftwagen\",\"genehmigungsnummer\":\"e11*2001/116*0262*11\",\"hoechsteZulaessigeAchsenlastAchse1\":930.0,\"hoechsteZulaessigeAchsenlastAchse2\":945.0,\"hoechstezulaessigeAnhaengelastGebremst\":950.0,\"hoechstezulaessigeAnhaengelastUngebremst\":600.0,\"hubraum\":1496.0,\"leistung\":74.0,\"antriebsart\":\"Benzin\",\"drehzahl\":6000.0,\"motortyp\":\"P5\",\"farbeDesFahrzeugs\":\"Braun\",\"sitzplaetze\":5.0,\"hoechstgeschwindigkeit\":182.0,\"standgeraeusch\":88.0,\"standgeraeuschDz\":3750.0,\"fahrgeraeusch\":70.0,\"co\":0.136,\"hc\":0.027,\"nox\":0.012,\"co2EmissionenNEFZ\":119.0,\"kraftstoffverbrauchNEFZ\":5.1,\"abgasverhaltenNachStufe\":\"Euro 5\",\"nameDesMitgliedstaates\":\"A\"}]}",
    "sub": "qyIsCvjlb-UQAjOaH2JJXFXtZj4eXECrTrsexxpBOEI=",
    "idp_issuer": "https://idp.ref.id-austria.gv.at"
}
On this page