Skip to content

Commit ea89637

Browse files
authored
Added documentation about the KOMBIT public certificate (#34)
1 parent d79d911 commit ea89637

File tree

2 files changed

+12
-0
lines changed

2 files changed

+12
-0
lines changed

source/installation-guide/installation-guide.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -235,6 +235,8 @@ OS2IoT-backend takes several environment variables as configuration, if these ar
235235
+-------------------------------+------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------+
236236
| KOMBIT_CERTIFICATEPRIVATEKEY | The certificate private key for KOMBIT adgangsstyring | :code:`null` |
237237
+-------------------------------+------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------+
238+
| KOMBIT_CERTIFICATEPUBLICKEY | Public certificate from the KOMBIT idp for verifying SAML response | :code:`"INSERT_KOMBIT_CERT"` |
239+
+-------------------------------+------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------+
238240
| KOMBIT_ROLE_NAME | This string must be a substring of the brugersystemrolle you grant users for them to be given access | :code:`http://os2iot.dk/roles/usersystemrole/adgang/` |
239241
+-------------------------------+------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------+
240242
| CHIRPSTACK_JWTSECRET | Secret to generate JWT for Chirpstack | :code:`verysecret` |

source/kombit-adgangsstyring/kombit-adgangsstyring.rst

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,9 @@ Prerequisites:
1616

1717
2. A NemID FOCES or VOCES (FOCES is preferred) for production use (Issued by: TRUST2408 OCES CA). If the OS2IoT installation is a TEST system, and the test environment for KOMBIT adgangsstyring is being used, then a FOCES/VOCES for the NemID integration environment is sufficent (Issued by: TRUST2408 Systemtest).
1818

19+
3. The public certificate from the KOMBIT IDP. Can be retrieved from
20+
a. **KOMBIT Test endpoint:** https://adgangsstyring.eksterntest-stoettesystemerne.dk/runtime/saml2/metadata.idp
21+
b. **KOMBIT Prod endpoint:** https://adgangsstyring.stoettesystemerne.dk/runtime/saml2/metadata.idp
1922

2023
Once the prerequisites are in order the configuration can begin.
2124

@@ -91,6 +94,13 @@ Steps:
9194
.. code-block:: javascript
9295
9396
KOMBIT_ENTRYPOINT="https://adgangsstyring.eksterntest-stoettesystemerne.dk/runtime/saml2/issue.idp"
97+
98+
iiiii. The variable :code:`KOMBIT_CERTIFICATEPUBLICKEY` must be set to the public key of the KOMBIT idp. If unset, the backend will not validate responses from KOMBIT, even if they are valid. Must be one line, with only the key part as shown below
99+
d. An example for :code:`.env` could be:
100+
101+
.. code-block:: javascript
102+
103+
KOMBIT_CERTIFICATEPUBLICKEY="MIIGHTCCBQWgAwIBAgIEXgiTCTA[...]H0QDoU9mHDP17gSZZ"
94104
95105
96106
Test:

0 commit comments

Comments
 (0)