Skip to content

Commit

Permalink
updated release (semver) + added OIN and Pkio
Browse files Browse the repository at this point in the history
  • Loading branch information
PieterHering committed Mar 23, 2021
1 parent 2e415a8 commit a13fa4d
Show file tree
Hide file tree
Showing 6 changed files with 107 additions and 7 deletions.
75 changes: 75 additions & 0 deletions OIN-SubOIN_in_PkioCert.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,75 @@
# Bijlage C - Invulling (Sub)OIN en naam in PKIoverheidcertifcaat

<aside class="note">
Onderstaande beschrijving moet nog geverifieerd worden door de TSP's.
</aside>

## Inleiding
Dit hoofdstuk beschrijft Invulling (Sub)OIN en Organisatienaam, en –onderdeel/voorziening/samenwerking in velden van het PKIO certificaat [[Eisen Pkioverheid]] [[PKI PvE 3b]] )

| Field/Attribute | C\* | | |
| --- | --- | --- | --- |
| Subject.organizationName | V | The full name of the subscriber's organization in accordance with the accepted document or Basic Registry | The subscriber organization is the organization with which the TSP has entered into an agreement and on behalf of which the certificate holder (server) communicates or acts |
| Subject.organizationalUnitName | O | Optional specification of an organizational entity. This attribute MUST NOT include a function indication or similar | This attribute MAY appear several times. The field MUST contain a valid name of an organizational entity of the subscriber in accordance with an accepted document or registry. |
| Subject.serialNumber | O | The TSP is responsible for safeguarding the uniqueness of the subject (service). The Subject.serialNumber MUST be used to identify the subject uniquely. The use of 20 positions is only allowed for OIN and HRN after additional arrangements with Logius | The number is determined by the TSP and/or the government. The number can differ for each domain and can be used for several applications. |

\*<span style="font-size:smaller">C=Criteria: V=Compulsory, O=Optional</span>

### Voorbeelden van invulling

In onderstaande voorbeelden wordt uitgegaan van de volgende (werkelijke) combinaties OIN + Organisatienaam

| Organisatie | OIN/SubOIN\*\* |
| -- | -- |
| Gemeente Utrecht | 00000001002220647000 |
| RVO - Bouw Utrecht Facturen | 00000004114202890000 |
| Logius (Digilevering Integrator) | 00000004194049711000 |
| Munitax | 00000004001094920000 |
| Deloitte Global Tax Center (Europe) | 00000008823631400000 |


\*\* <span style="font-size:smaller">Het OIN/SubOIN dient voor *identificatie* van een organisatie door een nummer. Het onderscheid of een OIN een (Hoofd)OIN of een SubOIN is in het gebruik in principe niet relevant.</span>

### voorbeelden uit de praktijk

<aside class="example">

**HoofdOIN**

| Subject.OrganizationName | Subject.organizationalUnitName | Subject.serialNumber |
| -- | -- | -- |
| **Gemeente Utrecht** | (leeg) | 00000001002220647000 |

**SubOIN (organisatieonderdeel)**

| Subject.OrganizationName | Subject.organizationalUnitName | Subject.serialNumber |
| -- | -- | -- |
| Rijksdienst voor Ondernemend Nederland | **RVO - Bouw Utrecht Facturen** | 00000004114202890000 |

**SubOIN (voorziening van een organisatie)**

| Subject.OrganizationName | Subject.organizationalUnitName | Subject.serialNumber |
| --- | --- | --- |
| Logius | **Logius (Digilevering Integrator)** | 00000004194049711000 |

**SubOIN (samenwerking(niet in [=HR=]) van meerdere organisaties, met één verantwoordelijke partij)**

| Subject.OrganizationName | Subject.organizationalUnitName | Subject.serialNumber |
| --- | --- | --- |
| Gemeente Beuningen | **Munitax** | 00000004001094920000 |

**SubOIN (Buitenlandse bank, geen [=HR=] registratie)**

| Subject.OrganizationName | Subject.organizationalUnitName | Subject.serialNumber |
| --- | --- | --- |
| Belastingdienst-registratie buitenlandse banken | **Deloitte Global Tax Center (Europe)** | 00000008823631400000 |

</aside>

### Raadplegen OINs en SubOINS in de Centrale OIN Raadpleegvoorziening (COR)

![Screenshot van de Website van de [=COR=]](media/screenshotCOR.png "Screenshot van de website van de [=COR=]")

### Raadplegen via de COR API

De COR kent ook aan publiek toegankelijke REST API om OINs van organisaties te raadplegen. De COR API biedt meer raadpleegmogelijkheden dan de website. Zie voor meer informatie [=COR=].
14 changes: 7 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,17 +6,17 @@ Het OIN stelsel
In dit document beschrijven we het doel en de werking van het OIN Stelsel. Het OIN is gestart als een noodzakelijk onderdeel van de Digikoppeling Standaard en is inmiddels een veel gebruikt identificatienummer binnen en maar ook buíten Digikoppeling. De regels van uitgifte en gebruik van het OIN staan beschreven in de *Voorwaarden Digikoppeling* en de *Gebruiksvoorwaarden Digikoppeling*. Daarnaast geeft Logius OINs en SubOINs uit en slaat de informatie hiervan op in het OIN register en ontsluit die met de *[=COR=]*, de Centrale OIN Raadpleegvoorziening. Dit geheel van regels en uitvoering noemen we het *OIN stelsel*.


Dit document is te raadplgen via:

- html: [https://Logius-standaarden.github.io/OIN-Stelsel](https://Logius-standaarden.github.io/OIN-Stelsel)
- html (static): [https://Logius-standaarden.github.io/OIN-Stelsel/snapshot.html](https://Logius-standaarden.github.io/OIN-Stelsel/snapshot.html)
Dit document is te raadplegen via:
- html (gepubliceerd): [https://publicatie.centrumvoorstandaarden.nl/dk/oin/](https://publicatie.centrumvoorstandaarden.nl/dk/oin/)
- html (werkversie): [https://Logius-standaarden.github.io/OIN-Stelsel](https://Logius-standaarden.github.io/OIN-Stelsel)
- html (snapshot): [https://Logius-standaarden.github.io/OIN-Stelsel/snapshot.html](https://Logius-standaarden.github.io/OIN-Stelsel/snapshot.html)
- pdf: [https://github.com/Logius-standaarden/OIN-Stelsel/blob/master/OIN-Stelsel.pdf](https://github.com/Logius-standaarden/OIN-Stelsel/blob/master/OIN-Stelsel.pdf)
- markdown (github): [https://github.com/Logius-standaarden/OIN-Stelsel](https://github.com/Logius-standaarden/OIN-Stelsel)

Waarom dit document
---------------------

De Voorwaarden Digikoppeling en de Digikoppeling Gebruiksvoorwaarden hebben een juridisch karakter en beantwoorden waarschijnlijk niet elke vraag van gebruikers van een OIN. In dit document proberen we daarom de werking van het OIN stelsel met al haar facetten nader te beschrijven in de hoop die vragen te beantwoorden.
De `Voorwaarden Digikoppeling` en de `Digikoppeling Gebruiksvoorwaarden` hebben een juridisch karakter en beantwoorden waarschijnlijk niet elke vraag van gebruikers van een OIN. In dit document proberen we daarom de werking van het OIN stelsel met al haar facetten nader te beschrijven in de hoop die vragen te beantwoorden.

Aanleiding voor een nieuwe versie van dit document
--------------------------------------------------
Expand Down Expand Up @@ -761,7 +761,7 @@ Onderstaande plaat beschrijft de functionaliteiten van de [=COR=] op hoofdlijnen



# Bijlage A Begrippen
# Bijlage A - Begrippen



Expand All @@ -774,7 +774,7 @@ Onderstaande plaat beschrijft de functionaliteiten van de [=COR=] op hoofdlijnen
|**<dfn>TSP</dfn>**|Certificatiedienstverlener (*Trust Service Provider*), marktpartijen die PKIoverheid certificaten verstrekken conform het Programma van Eisen van PKIoverheid. Voorheen CSP - Certificate Service provider-  genoemd.|
|**Digitaal berichtenverkeer**|Het uitwisselen van gegevens via digitale berichten|
|**Erkend authenticatiemiddel**|Een authenticatiestelsel voor organisaties waarbij natuurlijke personen namens de organisatie worden gemachtigd om specifieke activiteiten te verrichten. Bijvoorbeeld eHerkenning, Idensys.|
|**Handelsregister (HR)**|Het Handelsregister is een bij wet ingestelde basisregistratie voor rechtspersonen en ondernemingen in Nederland. Het maakt deel uit van het stelsel van basisregistraties. Daarmee draagt het Handelsregister bij aan een efficiëntere overheid en aan een betere dienstverlening voor ondernemers. Zie <http://www.digitaleoverheid.nl>
|**<dfn data-lt="HR">Handelsregister</dfn>(HR)**|Het Handelsregister is een bij wet ingestelde basisregistratie voor rechtspersonen en ondernemingen in Nederland. Het maakt deel uit van het stelsel van basisregistraties. Daarmee draagt het Handelsregister bij aan een efficiëntere overheid en aan een betere dienstverlening voor ondernemers. Zie <http://www.digitaleoverheid.nl>
|**<dfn>KvKnummer</dfn>**|Het KvKnummer is het inschrijvingsnummer van de onderneming in het Handelsregister. Elke onderneming of maatschappelijke activiteit krijgt in het handelsregister één KvK-nummer, dit KvK-nummer bestaat altijd uit 8 cijfers. Bij bedrijfsoverdracht houden ondernemingen wijzigt hun KvK-nummer.|
|**Niet-natuurlijk persoon**|Een niet-natuurlijk persoon is een organisatie of samenwerkingsverband dat rechten en plichten heeft en wordt gedefinieerd aan de hand van het [=RSIN=] (bron KvK).|
|**<dfn data-lt="SubOIN-beheerders">SubOIN-beheerder</dfn>**| Een overheidsorganisatie die door Logius de status is verleend om unieke identificerende nummers aan organisaties toe te kennen. Op basis van dat identificerende nummer wordt een SubOIN aangemaakt, vaak met een hiervoor specifiek gecreëerde prefix. De SubOIN-beheerder draagt zorg voor de registratie van SubOINs voor organisaties die niet in een aangesloten register voorkomen maar die wel bij een broninstantie of op basis van brondocumenten kunnen worden geïdentificeerd en geverifieerd. De SubOIN-beheerder stelt de identificatie van een partij vast aan de hand van bewijsstukken of zelfstandig onderzoek.|
Expand Down
1 change: 1 addition & 0 deletions index.html
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,7 @@
<section id='sotd'></section>

<section data-format="markdown" data-include="README.md"></section>
<section class="informative" data-format="markdown" data-include="OIN-SubOIN_in_PkioCert.md"></section>
<section id='conformance'></section>
<section id='tof'></section>
<section id="index"></section>
Expand Down
12 changes: 12 additions & 0 deletions js/config.js
Original file line number Diff line number Diff line change
Expand Up @@ -92,6 +92,8 @@ var respecConfig = {
// options simple, data, <your css>
nl_markdownTableClass: "dkkvs",

nl_markdownCodeClass: "code",

// if nl_markdownEmbedImageInFigure is set to true images in markdown generated content will be surrounded with <figures> element
// so that figures can be linked are be a part of table of figures
nl_markdownEmbedImageInFigure: true,
Expand Down Expand Up @@ -148,6 +150,16 @@ var respecConfig = {
"Algemene voorwaarden Logius",
date: "12 juni 2018",
publisher: "Logius",
},
"Eisen Pkioverheid": {
href: "https://www.logius.nl/diensten/pkioverheid/aansluiten-als-tsp/pogramma-van-eisen",
title: "Programma van Eisen (PKIoverheid)",
publisher: "Logius",
},
"PKI PvE 3b": {
href: "https://www.logius.nl/sites/default/files/public/bestanden/diensten/PKIoverheid/PvE%20EN%20part3e%20v4.8%20DEF.pdf",
title: "Programma van Eisen Pkioverheid, deel 3e",
publisher: "Logius",
}
}
//format: "markdown",
Expand Down
Binary file added media/screenshotCOR.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
12 changes: 12 additions & 0 deletions media/style.css
Original file line number Diff line number Diff line change
Expand Up @@ -56,4 +56,16 @@ table.dkkvsincell {
font-size: 8pt;
border-bottom: 0px solid #005a9c;

}

.code {
box-sizing: border-box;
border-collapse: collapse;
color: black;
padding: .2em .4em;
margin: 0;
font-size: 85%;
background-color: rgb(238, 230, 230);
border-radius: 6px;
font-family: SFMono-Regular,Consolas,Liberation Mono,Menlo,monospace;
}

0 comments on commit a13fa4d

Please sign in to comment.