Documentation/Editor/DataType/Application.rst
.. include:: ../../Includes.txt
.. _editor-dataTypes-application:
===========
Application
===========
.. figure:: ../../Images/application-record.png
:alt: Application Record
:class: with-shadow
Edit view of an existing application record.
.. _editor-dataTypes-application-properties:
Properties
==========
.. container:: ts-properties
============================== =========================================================================================== ======== ==========
Property Database Property Type Tab
============================== =========================================================================================== ======== ==========
Name :ref:`title <editor-dataTypes-application-properties-title>` string Basic
Domain / Auth0 Tenant :ref:`domain <editor-dataTypes-application-properties-domain>` string Basic
Client Identifier :ref:`id <editor-dataTypes-application-properties-id>` string Basic
Client Secret :ref:`secret <editor-dataTypes-application-properties-secret>` string Basic
JWT Signature Algorithm :ref:`signature_algorithm <editor-dataTypes-application-properties-signatureAlgorithm>` string Basic
Audience :ref:`audience <editor-dataTypes-application-properties-audience>` string Features
Single Log Out :ref:`single_log_out <editor-dataTypes-application-properties-singleLogOut>` boolean Features
Enabled hidden boolean Access
============================== =========================================================================================== ======== ==========
.. ### BEGIN~OF~TABLE ###
.. _editor-dataTypes-application-properties-title:
Name
----
.. container:: table-row
Property
title
Data type
string
Default
unset
Description
A unique, freely definable, name of your application.
.. _editor-dataTypes-application-properties-domain:
Domain
------
.. container:: table-row
Property
domain
Data type
string
Default
unset
Description
The domain of your Auth0 tenant. Your tenant is available under `tenant.region.auth0.com` by default. Please fill in this
URL without the protocol (without `https://`). If you are using **custom domains** you can fill in the URL of your
domain (e.g. `login.example.com`).
.. _editor-dataTypes-application-properties-id:
Client ID
---------
.. container:: table-row
Property
id
Data type
string
Default
unset
Description
The client ID of your Auth0 application.
.. _editor-dataTypes-application-properties-secret:
Client Secret
-------------
.. container:: table-row
Property
secret
Data type
string
Default
unset
Description
The client secret of your Auth0 application.
.. _editor-dataTypes-application-properties-signatureAlgorithm:
Signature Algorithm
-------------------
.. container:: table-row
Property
signature_algorithm
Data type
string
Default
:code:`RS256`
Description
The signature algorithm of the used JSON Web Token. Possible values are `RS256` and `HS256`
.. _editor-dataTypes-application-properties-api:
Use Auth0 (Management) API
--------------------------
.. container:: table-row
Property
api
Data type
boolean
Default
:code:`false`
Description
Whether you want to use the Auth0 management API to retrieve more information than that ones that are included in users
ID token. Please note that user and application metadata may not be available when using the management API is disabled.
.. _editor-dataTypes-application-properties-audience:
Audience
--------
.. container:: table-row
Property
audience
Data type
string
Default
:code:`api/v2/`
Description
This property contains the path to the audience of your Auth0 application. If you are using your tenant ID, the default
value should fit your needs. If you are using a **custom domain** you should adapt this configuration and fill in the
full URL of your audience (e.g. `https://tenant.region.auth0.com/api/v2/`). Please note that this option is only visible
when the :ref:`Auth0 Management API <editor-dataTypes-application-properties-api>` is used.
.. _editor-dataTypes-application-properties-singleLogOut:
Single Log Out
--------------
.. container:: table-row
Property
single_log_out
Data type
boolean
Default
:code:`true`
Description
Whether the user should be logged off in TYPO3 only (`false`) or logged off in Auth0 and TYPO3 (`true`).
.. _editor-dataTypes-application-customDomain:
Custom Domain
=============
If you are using a custom domain for your Auth0 tenant, than you have to do following configuration to log in using your custom
domain:
.. code-block:: typoscript
audience = https://tenant.region.auth0.com/api/v2/
domain = login.example.com