Skip to content

Commit

Permalink
Feature/docsmigrateupdate (#1932)
Browse files Browse the repository at this point in the history
* Updates

* Updates
  • Loading branch information
TheTechArch authored Dec 9, 2024
1 parent bcdd6fb commit 7082397
Show file tree
Hide file tree
Showing 3 changed files with 110 additions and 10 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -64,12 +64,62 @@ Functionally, the request contains

In a request, you can ask about several things simultaneously if needed.

#### Migration of Rights
#### Migration of Delegations

For most linked services, there are active delegations in Altinn 2. These are rights granted from an actor to a person or organization.
For these users to continue to have access after a transition to a resource in the resource registry, the rights must be migrated.
For most linked services, there are [active delegations in Altinn 2](https://github.com/Altinn/altinn-access-management/issues/579). These are rights that have been granted from an actor to a person or organization. For these users to continue to have access after a transition to the resource registry, the rights must be migrated over.

Altinn plans to offer the following
In Altinn Studio, you can start a batch on services created **based on an imported resource from Altinn 2** that:

-
- Deactivates the Altinn 2 service so that no changes to delegation can be made.
- Copies the delegations to the new resource in Altinn 3.

Currently, this function is hidden behind a feature flag in Altinn Studio.

```javascript
localStorage.setItem('featureFlags', "[\"resourceMigration\"]")
```

Run the command above in the browser console (available via developer tools).

Starting the batch job will take about 10 minutes before the job starts. The first thing the job does is deactivate the service before it runs the migration to Altinn 3.

The service must be migrated to the environment where you want to migrate delegations. We strongly recommend testing this in TT02 before running the job in Altinn 3.

![Migrate](migrationstep5.png "Migration of delegations in Altinn Studio")


After running, the delegations will be transferred. This must currently be checked manually as counting is not yet available.

We hope for feedback from service owners to adapt the process.

##### Create Reference to Altinn 2 Service

If you have created a resource in the Altinn 3 resource registry without using the import functionality, you can add a reference manually.

This can be done by the following methods:

**Edit Resource File in Gitea**

The format of what needs to be added is as follows:

```json
"resourceReferences": [
{
"referenceSource": "Altinn2",
"reference": "5600",
"referenceType": "ServiceCode"
},
{
"referenceSource": "Altinn2",
"reference": "100",
"referenceType": "ServiceEditionCode"
},
{
"referenceSource": "Altinn2",
"reference": "https://test.landbruksdirektoratet.no/disko/soker",
"referenceType": "Uri"
}
]
```

This can be added by editing the resource in Gitea. Remember to use the correct service codes and URL.
Original file line number Diff line number Diff line change
Expand Up @@ -66,14 +66,64 @@ Funksjonelt inneholder forespørselen

I en forespørsel kan man spørre om flere ting samtidig ved behov.

#### Migrering av delegeringer

#### Migrering av rettigheter
For de fleste lenketjenester finnes det [aktive delegeringer i Altinn 2](https://github.com/Altinn/altinn-access-management/issues/579). Dette er rettigheter som er gitt fra en aktør til en person eller organisasjon. For at disse brukerne skal ha fortsatt tilgang etter en overgang til ressursregisteret, må rettighetene migreres over.

For de fleste lenketjenester finnes det aktive delegeringer i Altinn 2. Dette er rettigheter som er gitt fra en aktør til en person eller organisasjon.
For at disse brukerne skal ha fortsatt tilgang etter en overgang til ressurs i ressursregisteret må rettighetene migreres over.
I Altinn Studio kan man på tjenester som er laget **basert på en importert ressurs fra Altinn 2** starte en batch som:

Altinn planlegger å tilby følgende
- Deaktiverer Altinn 2-tjenesten slik at ingen endring på delegering kan utføres.
- Kopierer over delegeringene til ny ressurs i Altinn 3.

Foreløpig er denne funksjonen gjemt bak et feature flag i Altinn Studio.

```javascript
localStorage.setItem('featureFlags', "[\"resourceMigration\"]")
```

Kjør kommandoen over i konsollen på nettleseren (tilgjengelig via utviklerverktøy).

Ved å starte batchjobben vil det ta ca. 10 minutter før jobben starter. Det første jobben gjør er å deaktivere tjenesten før den kjører migreringen til Altinn 3.

Tjenesten må være migrert til det miljøet du skal migrere delegeringer i. Vi anbefaler på det sterkeste å teste dette i TT02 før jobben kjøres i Altinn 3.

![Migrate](migrationstep5.png "Migrerings valg i Altinn Studio")

I etterkant av kjøringen vil delegeringene være overført. Dette må foreløpig sjekkes manuelt da telling ikke er tilgjengelig enda.

Her håper vi på tilbakemeldinger fra tjenesteeiere for å tilpasse prosessen.

##### Opprette referanse til Altinn 2-tjeneste

Hvis man har opprettet en ressurs i Altinn 3 ressursregister uten å bruke importfunksjonaliteten, kan man legge på referanse manuelt.

Dette kan gjøres ved følgende fremgangsmåter:

**Endre ressursfil i Gitea**

Formatet på det som må legges til er som følger:

```json
"resourceReferences": [
{
"referenceSource": "Altinn2",
"reference": "5600",
"referenceType": "ServiceCode"
},
{
"referenceSource": "Altinn2",
"reference": "100",
"referenceType": "ServiceEditionCode"
},
{
"referenceSource": "Altinn2",
"reference": "https://test.landbruksdirektoratet.no/disko/soker",
"referenceType": "Uri"
}
]
```

Dette kan legges til ved å redigere ressursen i Gitea. Husk å bruke riktig tjenestekoder og URL.

-


Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 7082397

Please sign in to comment.