Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Gestione AppFabric della produttività AppClients

È possibile gestire la produttività AppFabric per AppClients garantire il funzionamento e la manutenzione senza intoppi dei processi di autenticazione e autorizzazione.

Ottieni i dettagli di un AppClient

Utilizza il funzionamento dell' AppFabric GetAppClientAPI per visualizzare i dettagli del tuo AppClient, incluso il controllo dello AppClient stato. Per ulteriori informazioni, consulta GetAppClient.

Per ottenere i dettagli di un AppClient, devi disporre almeno delle autorizzazioni della policy "appfabric:GetAppClient" IAM. Per ulteriori informazioni, consulta Consenti l'accesso per ottenere i dettagli di AppClients.

Campi di richiesta

Campi di risposta

curl --request GET \
  --header "Content-Type: application/json" \
  --header "X-Amz-Content-Sha256: <sha256_payload>" \
  --header "X-Amz-Security-Token: <security_token>" \
  --header "X-Amz-Date: 20230922T172215Z" \
  --header "Authorization: AWS4-HMAC-SHA256 ..." \
  --url https://appfabric.<region>.amazonaws.com/appclients/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

200 OK

{
    "appClient": {
        "appName": "Test App",
        "arn": "arn:aws:appfabric:<region>:111122223333:appclient/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "customerManagedKeyArn": "arn:aws:kms:<region>:111122223333:key/<key>",
        "description": "This is a test app",
        "redirectUrls": [
            "https://localhost:8080"
        ],
        "starterUserEmails": [
            "anyuser@example.com"
        ],
        "verificationDetails": {
            "verificationStatus": "pending_verification"
        }
    }
}

Elenco AppClients

Usa l'operazione AppFabric ListAppClients API per visualizzare un elenco dei tuoi AppClients. AppFabric ne consente solo uno AppClient per Account AWS. Questo è soggetto a modifiche in futuro. Per ulteriori informazioni, consulta ListAppClients.

Per poter elencare AppClients, è necessario disporre almeno delle autorizzazioni relative alla policy "appfabric:ListAppClients" IAM. Per ulteriori informazioni, consulta Consenti l'accesso all'elenco AppClients.

Campi di richiesta

Campi di risposta

curl --request GET \
  --header "Content-Type: application/json" \
  --header "X-Amz-Content-Sha256: <sha256_payload>" \
  --header "X-Amz-Security-Token: <security_token>" \
  --header "X-Amz-Date: 20230922T172215Z" \
  --header "Authorization: AWS4-HMAC-SHA256 ..." \
  --url https://appfabric.<region>.amazonaws.com/appclients

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

200 OK

{
    "appClientList": [
        {
            "appClientArn": "arn:aws:appfabric:<region>:111122223333:appclient/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
            "verificationStatus": "pending_verification"
        }
    ]
}

Aggiorna un AppClient

Utilizza l'operazione AppFabric UpdateAppClient API per aggiornare gli URL di reindirizzamento mappati al tuo. AppClient Se è necessario modificare altri parametri, ad esempio, o altro AppName starterUserEmails, è necessario eliminarli AppClient e crearne uno nuovo. Per ulteriori informazioni, consulta UpdateAppClient.

Per aggiornare un AppClient, è necessario disporre almeno delle autorizzazioni della policy "appfabric:UpdateAppClient" IAM. Per ulteriori informazioni, consulta Consenti l'accesso all'aggiornamento AppClients.

Campi di richiesta

Campi di risposta

curl --request PATCH \
  --header "Content-Type: application/json" \
  --header "X-Amz-Content-Sha256: <sha256_payload>" \
  --header "X-Amz-Security-Token: <security_token>" \
  --header "X-Amz-Date: 20230922T172215Z" \
  --header "Authorization: AWS4-HMAC-SHA256 ..." \
  --url https://appfabric.<region>.amazonaws.com/appclients/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \
  --data '{
    "redirectUrls": ["https://localhost:8081"]
}'

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

200 OK

{
    "appClient": {
        "appName": "Test App",
        "arn": "arn:aws:appfabric:<region>:111122223333:appclient/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "customerManagedKeyArn": "arn:aws:kms:<region>:111122223333:key/<key>",
        "description": "This is a test app",
        "redirectUrls": [
            "https://localhost:8081"
        ],
        "starterUserEmails": [
            "anyuser@example.com"
        ],
        "verificationDetails": {
            "verificationStatus": "pending_verification"
        }
    }
}

Eliminare un AppClient

Usa l'operazione AppFabric DeleteAppClient API per eliminare quelli AppClients che non ti servono più. Per ulteriori informazioni, consulta DeleteAppClient.

Per eliminare un AppClient, devi disporre almeno delle autorizzazioni della policy "appfabric:DeleteAppClient" IAM. Per ulteriori informazioni, consulta Consenti l'accesso per l'eliminazione AppClients.

Campi di richiesta

Campi di risposta

curl --request DELETE \
  --header "Content-Type: application/json" \
  --header "X-Amz-Content-Sha256: <sha256_payload>" \
  --header "X-Amz-Security-Token: <security_token>" \
  --header "X-Amz-Date: 20230922T172215Z" \
  --header "Authorization: AWS4-HMAC-SHA256 ..." \
  --url https://appfabric.<region>.amazonaws.com/appclients/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111

Se l'operazione riesce, il servizio invia una risposta HTTP 204 con un corpo HTTP vuoto.

Token di aggiornamento per gli utenti finali

I token AppClient acquisiti per gli utenti finali possono essere aggiornati alla scadenza. Questo può essere fatto utilizzando l'TokenAPI con grant_type. refresh_token L'oggetto refresh_token da utilizzare viene restituito come parte della risposta dell'API del token quando grant_type è. authorization_code Le scadenze predefinite sono 12 ore. Per chiamare l'API di aggiornamento, devi disporre dell'autorizzazione della "appfabric:Token" policy IAM. Per ulteriori informazioni, consulta Token e Consenti l'accesso all'aggiornamento AppClients.

Campi di richiesta

Campi di risposta

curl --location \
"https://appfabric.<region>.amazonaws.com/oauth2/token" \
--header "Content-Type: application/json" \
--header "X-Amz-Content-Sha256: <sha256_payload>" \
--header "X-Amz-Security-Token: <security_token>" \
--header "X-Amz-Date: 20230922T172215Z" \
--header "Authorization: AWS4-HMAC-SHA256 ..." \
--data "{
    \"refresh_token\": \"<refresh_token>",
    \"app_client_id\": \"a1b2c3d4-5678-90ab-cdef-EXAMPLE11111\",
    \"grant_type\": \"refresh_token\"
}"

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

200 OK

{
    "expires_in": 43200,
    "token": "apkaeibaerjr2example",
    "token_type": "Bearer",
    "appfabric_user_id" : "${UserID}"
}