@digital-blueprint/authentic-documents-app
v1.0.19
Published
[GitHub Repository](https://github.com/digital-blueprint/authentic-documents-app) | [npmjs package](https://www.npmjs.com/package/@digital-blueprint/authentic-documents-app) | [Unpkg CDN](https://unpkg.com/browse/@digital-blueprint/authentic-documents-app
Downloads
164
Readme
Authentic Documents Application
GitHub Repository | npmjs package | Unpkg CDN | Authentic Document Bundle
With dbp authentic documents you can request official documents from a government registry and release them to third parties.
This is a WORK IN PROGRESS and not meant for public use yet!
Prerequisites
- You need the API server running
- You need the Authentic Document Bundle
Local development
# get the source
git clone [email protected]:digital-blueprint/authentic-documents-app.git
cd authenticdocument
git submodule update --init
# install dependencies
yarn install
# constantly build dist/bundle.js and run a local web-server on port 8001
yarn run watch
# run tests
yarn test
Jump to http://localhost:8001 and you should get a Single Sign On login page.
Using this app as pre-built package
Install app
If you want to install the DBP Authentic Document App in a new folder authentic-document-app
with a path prefix /
you can call:
npx @digital-blueprint/cli install-app authentic-document authentic-document-app /
Afterwards you can point your Apache web-server to authentic-document-app/public
.
Make sure you are allowing .htaccess
files in your Apache configuration.
Also make sure to add all of your resources you are using (like your API and Keycloak servers) to the
Content-Security-Policy
in your authentic-document-app/public/.htaccess
, so the browser allows access to those sites.
You can also use this app directly from the Unpkg CDN for example like this: dbp-authentic-document/index.html
Note that you will need a Keycloak server along with a client id for the domain you are running this html on.
Update app
If you want to update the DBP Authentic Document App in the current folder you can call:
npx @digital-blueprint/cli update-app authentic-document
Activities
This app has the following activities:
dbp-authentic-image-request
You can find the documentation of these activities in the authentic documents activities documentation.
Adapt app
Functionality
You can add multiple attributes to the <dbp-greenlight>
tag.
| attribute name | value | Link to description |
|----------------|-------| ------------|
| provider-root
| Boolean | app-shell |
| lang
| String | language-select |
| entry-point-url
| String | app-shell |
| keycloak-config
| Object | app-shell |
| base-path
| String | app-shell |
| src
| String | app-shell |
| html-overrides
| String | common |
| themes
| Array | theme-switcher |
| darkModeThemeOverride
| String | theme-switcher |
Mandatory attributes
If you are not using the provider-root
attribute to "terminate" all provider attributes
you need to manually add these attributes so that the topic will work properly:
<dbp-authentic-document
auth
requested-login-status
analytics-event
>
</dbp-authentic-document>
Design
For frontend design customizations, such as logo, colors, font, favicon, and more, take a look at the theming documentation.
"dbp-authentic-document" slots
These are common slots for the app-shell. You can find the documentation of these slots in the app-shell documentation. For the app specific slots take a look at the authentic documents activities.