Cambiare i domini primari e gestire l’accesso SFTP con l’API di Kinsta

Abbiamo aggiornato l’API di Kinsta con nuove funzioni di gestione dei domini e degli utenti, dando ai team un controllo ancora maggiore sui loro ambienti, senza dover accedere a MyKinsta.

Grazie a questi aggiornamenti, ora è possibile cambiare programmaticamente il dominio primario di un ambiente WordPress e gestire completamente altri account SFTP tramite l’API di Kinsta.

Cambiare il dominio primario di un ambiente

In precedenza, l’API di Kinsta permetteva di aggiungere o rimuovere domini dal sito, il che era ottimo per la configurazione e la pulizia. Ma non era possibile cambiare il dominio primario di un ambiente.

Con questa nuova versione, diventa possibile impostare un dominio esistente come nuovo dominio primario per un ambiente specifico utilizzando il seguente endpoint:

PUT /sites/environments/{env_id}/change-primary-domain

Per utilizzare l’endpoint, è necessario avere il domain_id del dominio che si vuole impostare come primario. Questo deve essere uno dei domini già associati all’ambiente.

Il domain_id si può trovare utilizzando gli endpoint Get Site by ID o Get Site Environments. La risposta è simile a questa:

"domains": [
  {
    "id": "54fb80af-576c-4fdc-ba4f-b596c83f15a1",
    "name": "example.com",
    "type": "live"
  }
]

Bisogna anche impostare il campo run_search_and_replace. Quando è impostato su true, questo attiva un’operazione di ricerca e sostituzione nel database del sito per aggiornare gli URL che fanno riferimento al dominio.

Ecco un esempio con curl:

curl -i -X PUT \
  'https://api.kinsta.com/v2/sites/environments/{env_id}/change-primary-domain' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "domain_id": "your-domain-id",
    "run_search_and_replace": true
  }'

Supporto completo per la gestione di altri account SFTP

Ad aprile abbiamo aggiunto la possibilità di creare e gestire più account utente SFTP direttamente nella dashboard di MyKinsta. Ora è possibile fare tutto questo utilizzando l’API di Kinsta.

Questo offre un controllo programmatico completo sugli utenti SFTP aggiuntivi in ogni ambiente. È possibile abilitare l’accesso, aggiungere nuovi utenti, elencare quelli esistenti o rimuoverli completamente.

Abilitare o disabilitare l’accesso

Prima di aggiungere utenti, è necessario abilitare l’accesso SFTP aggiuntivo per l’ambiente. Lo si può fare con:

PUT /sites/environments/{env_id}/additional-sftp-accounts/toggle-status

Ecco un esempio con curl:

curl -i -X PUT \
  'https://api.kinsta.com/v2/sites/environments/{env_id}/additional-sftp-accounts/toggle-status' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "enabled": true
  }'

Questa operazione può essere invertita in qualsiasi momento impostando "enabled": false.

Aggiungere un nuovo utente SFTP

Una volta abilitato l’accesso, è possibile aggiungere utenti con questo endpoint:

POST /sites/environments/{env_id}/additional-sftp-accounts

La richiesta permette di definire un nome utente, una password sicura (minimo 16 caratteri), una directory principale e un livello di autorizzazione (read o write).

curl -i -X POST \
  'https://api.kinsta.com/v2/sites/environments/{env_id}/additional-sftp-accounts' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "username": "dev-user",
    "password": "R8zXwT@#bV!kJq9^",
    "root_directory": "/wp-content/themes",
    "permission": "write"
  }'

Questo rispecchia gli stessi controlli che si trovano in MyKinsta, con la possibilità di limitare l’accesso a directory specifiche o di assegnare permessi di sola lettura.

Elenco e rimozione degli utenti

È possibile recuperare un elenco di account SFTP aggiuntivi in questo modo:

GET /sites/environments/{env_id}/additional-sftp-accounts

Per eliminarne uno:

DELETE /sites/environments/additional-sftp-accounts/{sftp_account_id}

Questo permette di automatizzare la rotazione degli account, di concedere un accesso limitato ai collaboratori o di revocare le credenziali dopo una distribuzione.

Nuovi metadati negli elenchi degli ambienti

Per supportare queste nuove funzionalità, abbiamo aggiunto il campo is_additional_sftp_accounts_enabled ai seguenti endpoint:

• GET /sites/{site_id}/environments
• GET /sites (quando si utilizza il parametro di query include_environments=true)

In questo modo è più facile verificare per quali ambienti è stato abilitato un accesso SFTP aggiuntivo, soprattutto se se ne gestiscono molti sulla piattaforma o sugli account dei clienti.

Più controllo per i team

Queste nuove funzioni dell’API offrono maggiore controllo sull’infrastruttura, sia nel caso in cui si voglia automatizzare il lavoro sullo staging, ruotare le credenziali SFTP o cambiare programmaticamente gli URL dei siti.

Tutti i dettagli sulle richieste/risposte sono nella documentazione dell’API di Kinsta. Le API di Kinsta permettono di fare moltissime cose e agenzie e sviluppatori le usano per gestire in modo efficiente centinaia di siti.

Sei pronto per iniziare con le API di Kinsta? Vai su MyKinsta per generare il tuo token API e inizia a costruire.