Integrazione degli endpoint di servizio

Tutte le implementazioni di Cloud Databases offrono l'integrazione con gli endpoint del servizioIBM Cloud per consentire le connessioni alle vostre implementazioni da Internet pubblico e dalla rete privata IBM Cloud.

Gli endpoint del servizio sono disponibili in tutte le regioni multizona IBM Cloud e in alcune regioni multizona a campus singolo. Le implementazioni in tutte le altre regioni sono in grado di utilizzare gli endpoint del servizio.

Endpoint privati

Una distribuzione con un endpoint del servizio sulla rete privata ottiene un endpoint che non è accessibile da internet pubblico. Questa è l'opzione predefinita per tutte le distribuzioni. Tutto il traffico viene instradato verso l'hardware dedicato alle implementazioni Cloud Databases e rimane sulla rete privata IBM Cloud. Tutto il traffico da e verso questo endpoint è gratuito e non misurato a condizione che il traffico rimanga in IBM Cloud. Una volta che l'ambiente ha accesso alla rete privata IBM Cloud, non è necessaria una connessione a Internet per collegarsi all'installazione client.

Per ulteriori informazioni, vedere Accesso sicuro ai servizi tramite endpoint di servizio.

Le implementazioni con endpoint privati sono raggiungibili da qualsiasi account all'interno della rete privata e l'accesso a ciascuna istanza richiede l'autenticazione. Per limitare l'accesso a indirizzi IP specifici o a intervalli di indirizzi IP, configurare le restrizioni basate sul contesto.

Endpoint pubblici

Gli endpoint pubblici forniscono una connessione alla tua distribuzione sulla rete pubblica. Il tuo ambiente deve disporre di un accesso a Internet per stabilire una connessione a una distribuzione.

Per una maggiore sicurezza, si consiglia agli utenti di connettersi alle proprie distribuzioni Cloud Databases usando endpoint privati invece di endpoint pubblici.

Abilitazione degli endpoint del servizio

Per utilizzare le connessioni tramite Internet pubblico, non è necessario abilitare gli endpoint del servizio sul proprio account IBM Cloud. Per abilitare la rete privata nelle installazioni, seguire le istruzioni riportate in Abilitazione di VRF ed endpoint di servizio.

Attualmente, l'abilitazione del routing e dell'inoltro virtuale (VRF) sul vostro account in Classic è un'operazione manuale che viene gestita tramite un ticket di assistenza. Il VRF è abilitato automaticamente per la VPC. Dopo aver completato la richiesta, controllare lo stato del ticket accedendo alla propria pagina di supporto su IBM Cloud.

Provisioning con endpoint di servizio attraverso l'interfaccia utente

Per configurare gli endpoint dell'installazione client in fase di provisioning, utilizzare il campo Endpoint nella pagina Provisioning. Selezionare una delle seguenti opzioni disponibili:

Rete privata
Rete pubblica
Rete pubblica e privata

Una distribuzione di MongoDB non può supportare contemporaneamente endpoint pubblici e privati. Questo non può essere modificato dopo il provisioning.

Provisioning con endpoint di servizio tramite CLI

Gli endpoint del servizio vengono specificati utilizzando un flag obbligatorio quando si esegue il provisioning tramite la CLI. Il provisioning è gestito dal Resource Controller. You can change the endpoints by passing the --service-endpoints flag with one of the following values: public, private, or public-and-private. Si consiglia di utilizzare endpoint privati.

ibmcloud resource service-instance-create <INSTANCE_NAME> <SERVICE_NAME> <SERVICE_PLAN_NAME> <LOCATION> <SERVICE_ENDPOINTS_TYPE> <RESOURCE_GROUP> -p '{"members_host_flavor": "<host_flavor value>"}' --service-endpoints=<ENDPOINT>

le distribuzioni di Cloud Databases, ad eccezione di Databases for MongoDB consentono di abilitare contemporaneamente la rete pubblica e quella privata.

Provisioning con endpoint di servizio attraverso l'API

Gli endpoint dei servizi sono abilitati tramite un parametro obbligatorio quando si effettua il provisioning tramite l'API. Il provisioning è gestito dal Resource Controller. Pass the service-endpoints parameter with one of the following options: public, private, or public-and-private. Si consiglia di utilizzare endpoint privati.

curl -X POST   https://resource-controller.cloud.ibm.com/v2/resource_instances   -H "Authorization: Bearer <TOKEN>"   -H 'Content-Type: application/json'     -d '{
    "name": "<INSTANCE_NAME",
    "location": "<LOCATION>",
    "resource_group": "RESOURCE_GROUP_ID",
    "resource_plan_id": "<SERVICE_PLAN_NAME>"
    "parameters": {
        "service-endpoints": "private"
   }
  }'

le distribuzioni di Cloud Databases, ad eccezione di Databases for MongoDB consentono di abilitare contemporaneamente la rete pubblica e quella privata.

Modifica degli endpoint del servizio

Dopo la distribuzione, è possibile modificare la configurazione degli endpoint dei servizi pubblici e privati, tranne che per Databases for MongoDB.

Modifica degli endpoint dei servizi attraverso l'interfaccia utente

Nella scheda Impostazioni della dashboard dell'installazione client, andare alla sezione Endpoint di servizio. Consente di selezionare i tipi di connessione disponibili per l'installazione.

La modifica del tipo di endpoint disponibili sull'installazione non causa alcun downtime dal punto di vista del database. Tuttavia, se si disabilita un endpoint utilizzato dall'utente o dalle sue applicazioni, le connessioni vengono interrotte.

Modifica degli endpoint di servizio tramite la CLI

Usare il comando ibmcloud resource service-instance-update nella CLI, specificando l'endpoint con il flag --service-endpoints.

ibmcloud resource service-instance-update <INSTANCE_NAME_OR_CRN> --service-endpoints <ENDPOINT-TYPE>

Modifica degli endpoint dei servizi attraverso l'API

Utilizzare l'opzione API del controllore di risorse, con una richiesta PATCH all'endpoint {id}.

Credenziali per endpoint privati

Usare stringhe di connessione pubbliche o private con qualsiasi set di credenziali creato per l'installazione. Per impostazione predefinita, le stringhe di connessione per un insieme di credenziali sono riempite con stringhe per la connessione su un endpoint pubblico. Se si utilizzano endpoint privati, specificare le stringhe di connessione che contengono l'endpoint privato da generare.

Quando si creano le credenziali nell'interfaccia utente delle credenziali del servizio, si può usare il parametro { "service-endpoints": "public" } o { "service-endpoints": "private" } per specificare quale endpoint viene inserito nelle stringhe di connessione. Per i passi da seguire per creare le credenziali, vedere l'argomento Gestione di utenti e ruoli nella documentazione del servizio scelto.

Nell'API, usare il simbolo /deployments/{id}/users/{userid}/connections/{endpoint_type} per recuperare le stringhe di connessione per gli endpoint pubblici o privati.

Se si hanno solo endpoint privati nelle distribuzioni, tutte le nuove credenziali avranno endpoint privati nelle stringhe di connessione.

Connessione tramite endpoint privati

Cloud Databases offre endpoint di servizi cloud pubblici e privati. Per eseguire l'applicazione o accedere all'endpoint da un browser che non si trova sulla rete privata, è necessario eseguire le seguenti operazioni aggiuntive:

Assicurarsi che l'account Cloud IaaS o SL sia abilitato per gli endpoint privati.
Creare una macchina virtuale (VSI) che esegua Linux.
Configurare un account utente con accesso SSH.
Dalla propria workstation, eseguire ssh -D 2345 user@vsi-host per avviare una sessione SSH e aprire un proxy SOCKS sulla porta 2345 che inoltra tutto il traffico attraverso il VSI.
Configurare il browser o l'applicazione per utilizzare un proxy SOCKS5 su localhost:2345.
Eseguire l'applicazione o aprire l'endpoint privato preferito nel browser (ad esempio, un'interfaccia utente di gestione).

Utilizzo di endpoint privati virtuali

Per ulteriori informazioni, vedere Endpoint privati virtuali.