Altinnrettigheter-proxy-klient

Bibliotek som tilbyr en Http klient til altinn-rettigheter-proxy. Klienten vil forsøke å kontakte Altinn via proxyen, som tilbyr caching på tvers av ulike tjenester i Nav. Klienten har en innebygd feilhåndtering, slik at dersom kall mot proxyen feiler vil det gjøres et nytt kall direkte mot Altinn sitt API.

Bruk av AltinnrettigheterProxyKlient

Biblioteket kan hentes fra JitPack. Legg til følgende i pom.xml

<repositories>
    <repository>
        <id>jitpack.io</id>
        <url>https://jitpack.io</url>
    </repository>
</repositories>

Biblioteket importeres i klientapplikasjon slik

<dependency>
    <groupId>com.github.navikt</groupId>
    <artifactId>altinn-rettigheter-proxy-klient</artifactId>
    <version>altinn-rettigheter-proxy-klient-5.0.0</version>
</dependency>

Klienten instansieres slik:

String consumerId = "navn-til-klient-applikasjon";

AltinnrettigheterProxyKlientConfig config =
        new AltinnrettigheterProxyKlientConfig(
                new ProxyConfig(consumerId, altinnProxyUrl),
                );

AltinnrettigheterProxyKlient klient = new AltinnrettigheterProxyKlient(config);

eller slik, hvis du ønsker fall-back-funksjonalitet

String consumerId = "navn-til-klient-applikasjon";

AltinnrettigheterProxyKlientConfig config =
        new AltinnrettigheterProxyKlientConfig(
                new ProxyConfig(consumerId, altinnProxyUrl),
                new AltinnConfig(altinnUrl, altinnApikey, altinnAPIGWApikey)
        );

AltinnrettigheterProxyKlient klient = new AltinnrettigheterProxyKlient(config);

Da skal det være mulig å hente listen av organisasjoner AltinnReportee en bruker har enkeltrettigheter i:

For en spesifikk tuple serviceCode og serviceEdition

List<AltinnReportee> organisasjoner =
        klient.hentOrganisasjoner(
                new SelvbetjeningToken(selvbetjeningTokenAsString),
                new Subject(fnrInnloggetBruker),
                new ServiceCode(serviceCode),
                new ServiceEdition(serviceEdition),
                true
        );

For alle enkelterettigheter

List<AltinnReportee> organisasjoner =
        klient.hentOrganisasjoner(
                new SelvbetjeningToken(selvbetjeningTokenAsString),
                new Subject(fnrInnloggetBruker) 
        true
                );

Hvor selvbetjeningTokenAsString er String verdi av selvbetjening-idtoken cookie til innlogget bruker.

Det er mulig å filtrere bort organisasjoner av type Person eller som ikke er aktive ved å sette siste parameteren filterPåAktiveOrganisasjoner til true

Komme i gang som utvikler

Biblioteket er skrevet i Kotlin. Koden kompileres med maven og produserer en jar fil altinn-rettigheter-proxy-klient-{version}.jar

mvn clean install

Lage og publisere en ny release

Forutsetning

Release tag skal være signert. Derfor må signering av commits være aktivert per default, med f.eks git config commit.gpgsign true

Prosess

Vi bruker mvn-release-plugin for å lage en ny release. I den prosessen skal en ny tag genereres. Artifact publiseres fra tag-en med GitHub actions.

Start med å rydde opp etter forrige release om det trenges ved å kjøre mvn release:clean

Lag en ny release med mvn release:prepare:

• Skriv inn nytt release version (skal følge semantic versioning: https://semver.org/)
• SCM release tag er preutfylt (bare trykk enter)
• new development version er også preutfylt (trykk enter)

Kommandoen skal pushe en ny tag på GitHub.

Maven Central

Tidligere har denne klienten blitt publisert til Maven Central. Fra og med versjon 5.0.0 publiseres ikke lenger til Maven Central, men kan hentes fra JitPack.

Henvendelser

Spørsmål knyttet til koden eller prosjektet kan stilles i issues her på GitHub.

For NAV-ansatte

Interne henvendelser kan sendes via Slack i kanalen #team-fager.