dezvoltarea serviciilor în Java, inclusiv API-urile REST, nu a fost întotdeauna ușoară sau productivă până când primăvara a venit și a schimbat peisajul. Au trecut mulți ani de atunci și au apărut noi cadre în comunitate.

unul dintre aceste cadre a fost Micronaut. Este dezvoltat de OCI, aceeași companie din spatele Grails, iar scopul lor este de a ajuta dezvoltatorii să creeze microservicii și aplicații fără server.

există și Quarkus, un alt cadru care a câștigat popularitate în ultimul an. Dezvoltat de RedHat, Quarkus promite să ofere o pornire rapidă și o utilizare mai mică a memoriei, două probleme comune la dezvoltarea serviciilor REST în Java.

cu toate aceste alegeri, există o întrebare foarte importantă de pus: cât de ușor este să creezi un serviciu cu fiecare dintre aceste trei cadre?

în acest tutorial, veți crea o aplicație sigură REST folosind Spring, Micronaut și Quarkus pentru a vedea cum diferă unul de celălalt și care se potrivește cel mai bine nevoilor dvs.

cuprins

• cerințe preliminare pentru API-ul Java REST
  • creați un cont Okta pentru gestionarea utilizatorilor
  • generați Jetoane folosind Debugger OpenID Connect
• construiți un API Java REST cu Micronaut
  • dezvoltați serviciul Java
• construiți un API Java REST cu Quarkus
• construiți un API Java REST cu Quarkus

cu Spring Boot

• gânduri finale pe API-urile REST cu Java: micronaut, Quarkus și spring boot

dacă doriți, puteți viziona acest tutorial ca un screencast.

cerințe preliminare pentru Java REST API

acest tutorial foloseste Maven 3+. Asigurați-vă că este instalat și disponibil pentru utilizare înainte de a continua. Puteți utiliza, de asemenea, cu siguranță Gradle, dar YMMV.

veți construi aplicații care autentifică cererile folosind OAuth 2.0, securizat de o aplicație Okta. Nu aveți un cont Okta? Nu vă faceți griji, este nevoie de mai puțin de un minut pentru a crea unul nou. Nu numai asta, dar Okta acceptă standarde precum JWT, OAuth 2.0 și oidc. Oferim suport pentru cadre cunoscute precum Java EE, Spring Boot și Spring Security. Heck, avem chiar și un plugin Maven care automatizează totul pentru tine.

nu este nevoie să reinventăm roata!

creați un cont Okta pentru gestionarea utilizatorilor

deschideți terminalul și executați următoarea comandă:

mvn com.okta:okta-maven-plugin:register

vi se va cere să introduceți următoarele informații:

• prenume
• prenume
• Email
• companie

odată ce ați răspuns la întrebări, veți primi un e-mail pentru a vă activa contul nou. După activarea contului, executați următoarea comandă:

mvn com.okta:okta-maven-plugin:spring-boot

această comandă creează o aplicație pentru dvs. cu fluxul de cod auth și URI-ul de redirecționare Spring Security pentru Okta.

pentru a-l aminti mai bine, puteți crea aceeași aplicație manual:

• accesați pagina de pornire a dezvoltatorului Okta și conectați-vă la contul dvs.
• Faceți clic pe aplicații> adăugați aplicația> Web> următor.

veți vedea următorul ecran:

înainte de a continua, efectuați următoarele modificări în aplicație:

• login redirect uri:
  • http://localhost:8080/login/oauth2/code/okta
  • https://oidcdebugger.com/debug
• tip de Grant permis
  • cod de autorizare
  • Implicit (hibrid)

tipul de grant implicit (cu ID și acces jeton permis verificat) este necesar pentru a prelua un jeton de acces în browser.

câmpurile care nu sunt menționate mai sus își pot păstra valorile implicite.

după ce îl terminați, faceți clic pe Terminat. Aplicația dvs. este gata!

următorul pas este să înveți cum să generezi un jeton valid folosind-o.

generați Jetoane folosind Debugger OpenID Connect

Okta vă permite să gestionați utilizatorii în cloud folosind API-urile sale. De asemenea, vă permite să vă securizați aplicațiile utilizând OAuth 2.0 și OpenID Connect (alias, OIDC). OAuth 2.0 oferă un mecanism de autorizare delegată, ceea ce înseamnă că nu trebuie să stocați acreditările de utilizator în aplicația dvs. În schimb, puteți delega acest lucru unui furnizor OAuth 2.0 (Okta, în acest caz). OIDC oferă un strat de identitate deasupra OAuth 2.0 și de aceea companii precum Okta sunt numite „furnizori de identitate” sau IDP.

v-ați înregistrat aplicația la Okta și acum Puteți genera un token pentru a avea acces la ea. Unul dintre uri-urile de redirecționare a autentificării pe care le-ați înregistrat este pentru site-ul OpenID Connect.

cererile dvs. vor fi validate folosind un token. Pentru a genera acest simbol, veți utiliza Debugger OpenID Connect. Acest site vă va oferi o modalitate ușoară de a genera acreditări pentru utilizatorii din aplicația dvs.

mergeți la https://oidcdebugger.com și completați următoarele informații:

• autorizați URI: https://{yourOktaDomain}/oauth2/default/v1/authorize
• redirecționați URI: https://oidcdebugger.com/debug
• ID Client:{yourOktaClientId}
• domeniu de aplicare:openid email profile
• Stat:dev
• Nonce: (păstrați valoarea implicită)
• tip de răspuns:token

puteți găsi valoarea pentru{yourOktaDomain} în colțul din dreapta sus al paginii de pornire a contului dvs.:

pentru a găsi ID-ul clientului Okta urmați pașii de mai jos:

• mergeți la aplicații
• Selectați aplicația mea Web
• Faceți clic pe General

ID-ul clientului va fi disponibil în secțiunea acreditări Client:

după ce completați toate câmpurile, faceți clic pe Trimite cerere. Veți fi redirecționat către pagina dvs. de conectare Okta.

odată ce ați autentificat cu succes, veți fi redirecționat către Oidc Debugger din nou, în cazul în care puteți vedea jetonul generat:

veți folosi acest token pentru a accesa în siguranță serviciile pe care le veți construi.

acum că aveți un cont Okta și știți cum să generați jetoane folosind aplicația Okta, să începem să comparăm cadrele!

construiți un API Java REST cu Micronaut

primul pas pentru dezvoltarea serviciului Micronaut este să descărcați SDKMAN!. SDKMAN! este un instrument pentru gestionarea versiunilor paralele ale mai multor SDK-uri, pe care le veți utiliza pentru a instala clientul Micronaut.

puteți descărca SDKMAN! executând următoarea comandă:

curl -s https://get.sdkman.io | bash

acum, Puteți instala Micronaut în sine. Doar executați următoarea comandă în terminal:

sdk install micronaut

după ce comanda se termină de executat, veți avea cea mai recentă versiune Micronaut disponibilă pe computer.

sunteți gata pentru a începe dezvoltarea aplicației!

Dezvoltați-vă serviciul Java

accesați directorul în care doriți să creați aplicația și executați următoarea comandă:

mn create-app com.okta.rest.app --build maven

această comandă va crea un proiect cu structura de bază a unui proiect Micronaut. Micronaut folosește Gradle în mod implicit, dar din moment ce utilizați --build maven, va folosi în schimb Maven.

următorul pas este să adăugați bibliotecile de securitate în interiorul proiectului. Editați fișierul pom.xml și adăugați următoarele dependențe:

<dependency> <groupId>io.micronaut</groupId> <artifactId>micronaut-security</artifactId></dependency><dependency> <groupId>io.micronaut</groupId> <artifactId>micronaut-security-jwt</artifactId></dependency>

aceste dependențe vor activa securitatea – în special OAuth 2.0 cu JWT – în interiorul proiectului. Acum că aveți toate dependențele la locul lor, puteți începe să vă creați punctul final.

creați următoarea clasă în src/main/java/com/okta/rest/controller:

package com.okta.rest.controller;import io.micronaut.http.MediaType;import io.micronaut.http.annotation.Controller;import io.micronaut.http.annotation.Get;import io.micronaut.http.annotation.Produces;import io.micronaut.security.annotation.Secured;import io.micronaut.security.rules.SecurityRule;import java.security.Principal;@Controller("/hello")public class HelloController { @Get @Secured(SecurityRule.IS_AUTHENTICATED) @Produces(MediaType.TEXT_PLAIN) public String hello(Principal principal) { return "Hello, " + principal.getName() + "!"; }}

micronaut.security.enabled=truemicronaut.security.token.jwt.enabled=truemicronaut.security.token.jwt.signatures.jwks.okta.url=https://{yourOktaDomain}/oauth2/default/v1/keys

./mvnw mn:run

curl -X GET -I http://localhost:8080/hello

HTTP/1.1 401 UnauthorizedDate: Tue, 8 Jan 2019 15:47:36 GMTtransfer-encoding: chunkedconnection: close

TOKEN=eyJraWQiOiJxOE1QMjFNNHZCVmxOSkxGbFFWNlN...

curl -H "Authorization: Bearer $TOKEN" http://localhost:8080/hello

Hello, [email protected]!

mvn io.quarkus:quarkus-maven-plugin:1.8.1.Final:create \ -DprojectGroupId=com.okta.rest \ -DprojectArtifactId=quarkus \ -DclassName="com.okta.rest.quarkus.HelloResource" \ -Dpath="/hello" \ -Dextensions="jwt"

package com.okta.rest.quarkus;import io.quarkus.security.Authenticated;import javax.ws.rs.GET;import javax.ws.rs.Path;import javax.ws.rs.Produces;import javax.ws.rs.core.Context;import javax.ws.rs.core.MediaType;import javax.ws.rs.core.SecurityContext;import java.security.Principal;@Path("/hello")public class HelloResource { @GET @Path("/") @Authenticated @Produces(MediaType.TEXT_PLAIN) public String hello(@Context SecurityContext context) { Principal userPrincipal = context.getUserPrincipal(); return "Hello, " + userPrincipal.getName() + "!"; }}

mp.jwt.verify.publickey.location=https://{yourOktaDomain}/oauth2/default/v1/keysmp.jwt.verify.issuer=https://{yourOktaDomain}/oauth2/default

./mvnw compile quarkus:dev

curl -X GET -I http://localhost:8080/hello

HTTP/1.1 401 Unauthorizedwww-authenticate: Bearer {token}Content-Length: 0

curl -H "Authorization: Bearer $TOKEN" http://localhost:8080/hello

Hello, [email protected]!

curl https://start.spring.io/starter.zip -d language=java \ -d bootVersion=2.3.4.RELEASE \ -d dependencies=web,okta \ -d packageName=com.okta.rest \ -d name=spring-boot \ -d type=maven-project \ -o spring-boot.zip

unzip spring-boot.zip -d spring-boot

package com.okta.rest.controller;import org.springframework.security.core.annotation.AuthenticationPrincipal;import org.springframework.web.bind.annotation.GetMapping;import org.springframework.web.bind.annotation.RestController;import java.security.Principal;@RestControllerpublic class HelloController { @GetMapping("/hello") public String hello(@AuthenticationPrincipal Principal principal) { return "Hello, " + principal.getName() + "!"; }}

okta.oauth2.issuer=https://{yourOktaDomain}/oauth2/default

./mvnw spring-boot:run

curl -X GET -I http://localhost:8080/hello

HTTP/1.1 401Set-Cookie: JSESSIONID=316DCFD55C302A8D69EFD865411DFA77; Path=/; HttpOnlyWWW-Authenticate: BearerX-Content-Type-Options: nosniffX-XSS-Protection: 1; mode=blockCache-Control: no-cache, no-store, max-age=0, must-revalidatePragma: no-cacheExpires: 0X-Frame-Options: DENYContent-Length: 0Date: Thu, 09 Jan 2020 15:46:34 GMT

curl -H "Authorization: Bearer $TOKEN" http://localhost:8080/hello

Hello, [email protected]!