Aggiunta di criteri richiesta di trasformazione intestazione

Creare o aggiornare una distribuzione API utilizzando la console, selezionare l'opzione Crea distribuzione e immettere i dettagli nella pagina Informazioni di base.

Per ulteriori informazioni, vedere Distribuzione di un'interfaccia API in un Gateway API mediante la creazione di una distribuzione API e Aggiornamento di un Gateway API.

Selezionare Successivo e specificare le opzioni di autenticazione nella pagina Autenticazione.

Per ulteriori informazioni sulle opzioni di autenticazione, vedere Aggiunta di autenticazione e autorizzazione alle distribuzioni API.

Selezionare Successivo per immettere i dettagli dei singoli instradamenti nella distribuzione API nella pagina Cicli.

Per limitare le intestazioni incluse in una richiesta, specificare:

• Azione: filtro.
• Tipo: Blocca per rimuovere dalla richiesta le intestazioni elencate in modo esplicito oppure Consenti di consentire solo nella richiesta le intestazioni elencate in modo esplicito (qualsiasi altra intestazione viene rimossa dalla richiesta).
• Nomi intestazione: la lista delle intestazioni da rimuovere dalla richiesta o da consentire nella richiesta (a seconda dell'impostazione di Tipo). I nomi specificati non fanno distinzione tra maiuscole e minuscole e non devono essere inclusi in altri criteri di richiesta di trasformazione per l'instradamento (ad eccezione degli elementi filtrati come consentito). Ad esempio, User-Agent.

Per modificare il nome di un'intestazione inclusa in una richiesta (mantenendone il valore originale), specificare:

• Azione: rinominare.
• Nome intestazione: il nome originale dell'intestazione che si sta rinominando. Il nome specificato non fa distinzione tra maiuscole e minuscole e non deve essere incluso in altri criteri di richiesta di trasformazione per l'instradamento. Ad esempio, X-Username.
• Nuovo nome intestazione: il nuovo nome dell'intestazione che si sta rinominando. Il nome specificato non fa distinzione tra maiuscole e minuscole (la maiuscola potrebbe essere ignorata) e non deve essere incluso in altri criteri di richiesta di trasformazione per l'instradamento (ad eccezione degli elementi filtrati come consentito). Ad esempio, X-User-ID.

Per aggiungere una nuova intestazione a una richiesta (o per modificare o mantenere i valori di un'intestazione esistente già inclusa in una richiesta), specificare:

• Azione: impostare.

• Comportamento: se l'intestazione esiste già, specificare le azioni da eseguire con il valore esistente dell'intestazione:

  • Sovrascrivi, per sostituire il valore esistente dell'intestazione con il valore specificato.
  • Aggiungi, per aggiungere il valore specificato al valore esistente dell'intestazione.
  • Ignora per mantenere il valore esistente dell'intestazione.
• Nome intestazione: il nome dell'intestazione da aggiungere alla richiesta o modificare il valore di. Il nome specificato non fa distinzione tra maiuscole e minuscole (la maiuscola potrebbe essere ignorata) e non deve essere incluso in altri criteri di richiesta di trasformazione per l'instradamento (ad eccezione degli elementi filtrati come consentito). Ad esempio, X-Api-Key.
• Valori: il valore della nuova intestazione (o il valore da sostituire o aggiungere al valore di un'intestazione esistente, a seconda dell'impostazione di Comportamento). È possibile specificare più valori. Il valore specificato può essere una stringa semplice oppure può includere variabili di contesto (ad eccezione di request.body) racchiuse nei delimitatori ${...}. Ad esempio, "value": "zyx987wvu654tsu321", "value": "${request.path[region]}", "value": "${request.headers[opc-request-id]}".

Utilizzando l'editor JSON preferito, modificare la specifica di distribuzione API esistente a cui si desidera aggiungere criteri di richiesta di trasformazione dell'intestazione o creare una nuova specifica di distribuzione API (vedere Creazione di una specifica di distribuzione API).

Ad esempio, la seguente specifica di distribuzione API di base definisce una semplice funzione serverless Hello World in OCI Functions come un singolo back end:

{
  "routes": [
    {
      "path": "/hello",
      "methods": ["GET"],
      "backend": {
        "type": "ORACLE_FUNCTIONS_BACKEND",
        "functionId": "ocid1.fnfunc.oc1.phx.aaaaaaaaab______xmq"
      }
    }
  ]
}

Inserire una sezione requestPolicies dopo la sezione backend per l'instradamento a cui si desidera applicare il criterio della richiesta di trasformazione dell'intestazione. Ad esempio:

{
  "routes": [
    {
      "path": "/hello",
      "methods": ["GET"],
      "backend": {
        "type": "ORACLE_FUNCTIONS_BACKEND",
        "functionId": "ocid1.fnfunc.oc1.phx.aaaaaaaaab______xmq"
      },
      "requestPolicies": {}
    }
  ]
}

Aggiungere una sezione headerTransformations alla sezione requestPolicies.

{
  "routes": [
    {
      "path": "/hello",
      "methods": ["GET"],
      "backend": {
        "type": "ORACLE_FUNCTIONS_BACKEND",
        "functionId": "ocid1.fnfunc.oc1.phx.aaaaaaaaab______xmq"
      },
      "requestPolicies": {
        "headerTransformations":{}
      }
    }
  ]
}

Per limitare le intestazioni incluse in una richiesta, specificare un criterio di richiesta di trasformazione dell'intestazione filterHeaders:

{
  "routes": [
    {
      "path": "/hello",
      "methods": ["GET"],
      "backend": {
        "type": "ORACLE_FUNCTIONS_BACKEND",
        "functionId": "ocid1.fnfunc.oc1.phx.aaaaaaaaab______xmq"
      },
      "requestPolicies": {
        "headerTransformations": {
          "filterHeaders": {
            "type": "<BLOCK|ALLOW>",
            "items": [
              {
                "name": "<header-name>"
              }
            ]
          }
        }
      }
    }
  ]
}

dove:

• "type": "<BLOCK|ALLOW>" indica cosa fare con le intestazioni specificate da "items":[{"name":"<header-name>"}]:
  • Utilizzare BLOCK per rimuovere dalla richiesta le intestazioni elencate in modo esplicito.
  • Utilizzare ALLOW per consentire nella richiesta solo le intestazioni elencate in modo esplicito (qualsiasi altra intestazione viene rimossa dalla richiesta).
• "name":"<header-name> è un'intestazione da rimuovere dalla richiesta o da consentire nella richiesta (a seconda dell'impostazione di "type": "<BLOCK|ALLOW>"). Il nome specificato non fa distinzione tra maiuscole e minuscole e non deve essere incluso in altri criteri di richiesta di trasformazione per l'instradamento (ad eccezione degli elementi negli elenchi ALLOW). Ad esempio, User-Agent.

È possibile rimuovere e consentire fino a 50 intestazioni in un criterio di richiesta di trasformazione dell'intestazione filterHeaders.

Ad esempio:

{
  "routes": [
    {
      "path": "/hello",
      "methods": ["GET"],
      "backend": {
        "type": "ORACLE_FUNCTIONS_BACKEND",
        "functionId": "ocid1.fnfunc.oc1.phx.aaaaaaaaab______xmq"
      },
      "requestPolicies": {
        "headerTransformations": {
          "filterHeaders": {
            "type": "BLOCK",
            "items": [
              {
                "name": "User-Agent"
              }
            ]
          }
        }
      }
    }
  ]
}

In questo esempio, il gateway API rimuove l'intestazione User-Agent da tutte le richieste in entrata.

Per modificare il nome di un'intestazione inclusa in una richiesta (mantenendone il valore originale), specificare un criterio di richiesta di trasformazione dell'intestazione renameHeaders:

{
  "routes": [
    {
      "path": "/hello",
      "methods": ["GET"],
      "backend": {
        "type": "ORACLE_FUNCTIONS_BACKEND",
        "functionId": "ocid1.fnfunc.oc1.phx.aaaaaaaaab______xmq"
      },
      "requestPolicies": {
        "headerTransformations": {
          "renameHeaders": {
            "items": [
              {
                "from": "<original-name>",
                "to": "<new-name>"
              }
            ]
          }
        }
      }
    }
  ]
}

dove:

• "from": "<original-name>" è il nome originale dell'intestazione che si sta rinominando. Il nome specificato non fa distinzione tra maiuscole e minuscole e non deve essere incluso in altri criteri di richiesta di trasformazione per l'instradamento. Ad esempio, X-Username.
• "to": "<new-name>" è il nuovo nome dell'intestazione che si sta rinominando. Il nome specificato non fa distinzione tra maiuscole e minuscole (la maiuscola potrebbe essere ignorata) e non deve essere incluso in altri criteri di richiesta di trasformazione per l'instradamento (ad eccezione degli elementi negli elenchi ALLOW). Ad esempio, X-User-ID.

È possibile rinominare fino a 20 intestazioni in un criterio di richiesta di trasformazione dell'intestazione renameHeaders.

Ad esempio:

{
  "routes": [
    {
      "path": "/hello",
      "methods": ["GET"],
      "backend": {
        "type": "ORACLE_FUNCTIONS_BACKEND",
        "functionId": "ocid1.fnfunc.oc1.phx.aaaaaaaaab______xmq"
      },
      "requestPolicies": {
        "headerTransformations": {
          "renameHeaders": {
            "items": [
              {
                "from": "X-Username",
                "to": "X-User-ID"
              }
            ]
          }
        }
      }
    }
  ]
}

In questo esempio, il gateway API rinomina qualsiasi intestazione X-Username in X-User-ID, mantenendo il valore originale dell'intestazione.

Per aggiungere una nuova intestazione a una richiesta (o per modificare o mantenere i valori di un'intestazione esistente già inclusa in una richiesta), specificare un criterio di richiesta di trasformazione dell'intestazione setHeaders:

{
  "routes": [
    {
      "path": "/hello",
      "methods": ["GET"],
      "backend": {
        "type": "ORACLE_FUNCTIONS_BACKEND",
        "functionId": "ocid1.fnfunc.oc1.phx.aaaaaaaaab______xmq"
      },
      "requestPolicies": {
        "headerTransformations": {
          "setHeaders": {
            "items": [
              {
                "name": "<header-name>",
                "values": ["<header-value>"],
                "ifExists": "<OVERWRITE|APPEND|SKIP>"
              }
            ]
          }
        }
      }
    }
  ]
}

dove:

• "name":"<header-name> è il nome dell'intestazione da aggiungere alla richiesta (o per modificare il valore di). Il nome specificato non fa distinzione tra maiuscole e minuscole e non deve essere incluso in altri criteri di richiesta di trasformazione per l'instradamento (ad eccezione degli elementi negli elenchi ALLOW). Ad esempio, X-Api-Key.
• "values": ["<header-value>"] è il valore della nuova intestazione (o il valore da sostituire o aggiungere al valore di un'intestazione esistente, a seconda dell'impostazione di "ifExists": "<OVERWRITE|APPEND|SKIP>"). Il valore specificato può essere una stringa semplice oppure può includere variabili di contesto (ad eccezione di request.body) racchiuse nei delimitatori ${...}. Ad esempio, "values": "zyx987wvu654tsu321", "values": "${request.path[region]}", "values": "${request.headers[opc-request-id]}".

  È possibile specificare fino a 10 valori. Se si specificano più valori, il gateway API aggiunge un'intestazione per ogni valore.

• "ifExists": "<OVERWRITE|APPEND|SKIP>" indica cosa fare con il valore esistente dell'intestazione se l'intestazione specificata da <header-name> esiste già:

  • Utilizzare OVERWRITE per sostituire il valore esistente dell'intestazione con il valore specificato.
  • Utilizzare APPEND per aggiungere il valore specificato al valore esistente dell'intestazione.
  • Utilizzare SKIP per mantenere il valore esistente dell'intestazione.

  Se non specificato, l'impostazione predefinita è OVERWRITE.

È possibile aggiungere o modificare i valori di un massimo di 20 intestazioni in un criterio di richiesta di trasformazione dell'intestazione setHeaders.

Ad esempio:

{
  "routes": [
    {
      "path": "/hello",
      "methods": ["GET"],
      "backend": {
        "type": "ORACLE_FUNCTIONS_BACKEND",
        "functionId": "ocid1.fnfunc.oc1.phx.aaaaaaaaab______xmq"
      },
      "requestPolicies": {
        "headerTransformations": {
          "setHeaders": {
            "items": [
              {
                "name": "X-Api-Key",
                "values": ["zyx987wvu654tsu321"],
                "ifExists": "OVERWRITE"
              }
            ]
          }
        }
      }
    }
  ]
}

In questo esempio, il gateway API aggiunge l'intestazione X-Api-Key:zyx987wvu654tsu321 a tutte le richieste in entrata. Se per una richiesta in entrata è già impostata un'intestazione X-Api-Key su un valore diverso, il gateway API sostituisce il valore esistente con zyx987wvu654tsu321.

Utilizzare la specifica di distribuzione API quando si crea o si aggiorna una distribuzione API nei modi riportati di seguito.

• specificando il file JSON nella console quando si seleziona l'opzione Carica un'API di distribuzione esistente
• specificando il file JSON in una richiesta all'API REST del gateway API

Per ulteriori informazioni, vedere Distribuzione di un'interfaccia API in un Gateway API mediante la creazione di una distribuzione API e Aggiornamento di un Gateway API.