Informazioni di riferimento sulla riga di comando per Microsoft Tunnel Gateway

Le informazioni contenute in questo riferimento per Microsoft Tunnel Gateway vengono fornite per supportare l'installazione e la manutenzione dell'installazione del tunnel nell'ambiente in uso.

Strumento da riga di comando mst-cli per Microsoft Tunnel Gateway

Mst-cli è uno strumento della riga di comando da usare con Microsoft Tunnel Gateway. Questo strumento è disponibile sul server Linux dopo che il tunnel ha completato l'installazione e si trova in /usr/sbin/mst-cli. Alcune attività che è possibile completare con questo strumento includono:

• Ottenere informazioni sul server tunnel.
• Impostare o aggiornare la configurazione del server tunnel.
• Riavviare il server tunnel.
• Disinstallare il server tunnel.

Di seguito è riportato un uso comune dello strumento da riga di comando.

Interfaccia della riga di comando:

• mst-cli –help - Utilizzo: mst-cli [comando]

  Comandi

  • agent - Operare sul componente agente.
  • server - Operare sul componente server.
  • uninstall - Disinstalla Microsoft Tunnel.
  • eula - Mostra il End-User Contratto di licenza (EULA).
  • import_cert - Importa o aggiorna il certificato TLS.

• mst-cli agent –help - Utilizzo: mst-cli agent [comando]

  Comandi:

  • logs - Mostra i registri degli agenti. (Usa -h per maggiori informazioni.)
  • status - Mostra lo stato dell'agente.
  • start - Avvia il servizio agente.
  • stop - Interrompere il servizio agente.
  • restart - Riavviare il servizio agente.

• mst-cli agent logs help - Utilizzo: registri dell'agente mst-cli [flag]

  Bandiere:

  • -f, --follow - Segui l'output del registro. L'impostazione predefinita è false.
  • --since string - Mostra i registri dal TIMESTAMP.
  • --tail uint - Restituisce il numero specificato di RIGHE alla fine dei log. Il valore predefinito è zero (0), che stampa tutte le righe.
  • -t, --timestamps - Emetti i timestamp nel registro.

• mst-cli agent status - I seguenti risultati sono esempi di risultati che potresti vedere:

  • Stato: in esecuzione
  • Salute: sana

• mst-cli agent start - Avvia l'agente se è fermo.

• mst-cli agent stop - Arresta l'agente. Deve essere avviato manualmente dopo l'arresto.

• mst-cli agent restart - Riavvia l'agente.

• mst-cli server --help - Utilizzo: mst-cli server [comando]

  Comandi:

  • logs - Mostra i log del server. Usa -h per altre informazioni.
  • status - Mostra lo stato del server.
  • start - Avviare il servizio server.
  • stop - Arresta il servizio server.
  • restart - Riavviare il servizio server.
  • show - Mostra varie statistiche del server. Usa -h per altre informazioni.

• mst-cli server logs –help - Utilizzo: mst-cli server logs [flag]

  Bandiere:

  • -f, --follow - Segui l'output del registro. L'impostazione predefinita è false.
  • --since string - Mostra i registri dal TIMESTAMP
  • --tail uint - Restituisce il numero specificato di RIGHE alla fine dei log. Il valore predefinito è zero (0), che stampa tutte le righe.
  • -t, --timestamps - Emetti i timestamp nel registro.

• mst-cli server status - I seguenti risultati sono esempi di risultati che potresti vedere:

  • Stato: in esecuzione
  • Salute: sana

• mst-cli server start - Avvia il server se è arrestato.

• mst-cli server stop - Arresta il server. Deve essere avviato manualmente dopo l'arresto.

• mst-cli server restart - Riavvia il server.

• mst-cli server show

  • show status - Stampa lo stato e le statistiche del server.
  • show users - Stampa gli utenti connessi.
  • show ip bans - Stampa gli indirizzi IP vietati.
  • show ip ban points - Stampa tutti gli indirizzi IP noti che hanno punti.
  • show iroutes - Stampa le route fornite dagli utenti del server.
  • show sessions all - Stampa tutti gli ID sessione.
  • show sessions valid - Stampa tutti i dati validi per le sessioni di riconnessione.
  • show session [SID] - Stampa le informazioni sulla sessione specificata.
  • show user [NAME] - Stampa le informazioni sull'utente specificato.
  • show id [ID] - Stampa le informazioni sull'ID specificato.
  • show events - Fornisce informazioni sulla connessione degli utenti.
  • show cookies all - Alias per tutte le sessioni di spettacolo.
  • show cookies valid - Alias per le sessioni di spettacolo valido.

Variabili di ambiente

Di seguito sono riportate le variabili di ambiente che è possibile configurare quando si installa il software Microsoft Tunnel Gateway sul server Linux. Queste variabili si trovano nel file di ambiente /etc/mstunnel/env.sh:

• http_proxy=[address] - Indirizzo HTTP per il server proxy.
• https_proxy=[address] - Indirizzo HTTPs per il server proxy.

Percorsi dati

Files aggiunti durante l'installazione del server

/etc/mstunnel:

• admin-settings.json:

  • Contiene la configurazione server serializzata da Intune.
  • Creato dopo la registrazione del server.

• agent-info.json:

  • Creato al termine della registrazione.
  • AgentId, IntuneTenantId, AADTenantId e il certificato dell'agente RenewalDate.
  • Aggiornato sul rinnovo del certificato dell'agente.

• privato/agente.p12:

  • Certificato PFX usato per l'autenticazione dell'agente in Intune.
  • Rinnovato automaticamente.

• version-info.json:

  • Contiene informazioni sulla versione per i vari componenti.
  • ConfigVersion, DockerVersion, AgentImageHash, AgentCreateDate, ServerImageHash, ServerCreateDate.

• ocserv.conf:

  • Configurazione del server

• Images_configured

Immagini Docker usate per creare i contenitori:

• agentImageDigest
• serverImageDigest

Esempio di admin-settings.json

{
"PolicyName": "Auto Generated Policy for rh7vm",
   "DisplayName": "rh7vm Policy",
   "Description": "This policy was auto generated for rh7vm",
   "Network": "169.100.0.0/16",
   "DNSServers": ["168.63.129.16"],
   "DefaultDomainSuffix": "nmqjwlanybmubp4imht0k2b4qd.xx.internal.cloudapp.net",
   "RoutesInclude": ["default"],
   "RoutesExclude": [],
   "ListenPort": 443
}

Comandi Docker

Di seguito sono riportati i comandi comuni per Docker che possono essere utili se è necessario esaminare i problemi su un server tunnel.

Interfaccia della riga di comando:

• docker ps –a – Vedi tutti i contenitori.

  • mstunnel-server : questo contenitore esegue i componenti del server ocserv e usa la porta in ingresso 443 (impostazione predefinita) o una configurazione di porta personalizzata.
  • mstunnel-agent: questo contenitore esegue il connettore di Intune e usa la porta 443 in uscita.

• Per riavviare Docker:

  • systemctl restart docker

• Per eseguire qualcosa in un contenitore:

  • docker exec –it mstunnel-server bash
  • docker exec –it mstunnel-agent bash

Comandi di Podman

Di seguito sono riportati i comandi per Podman che possono essere utili se è necessario indagare sui problemi su un server tunnel. Per ulteriori comandi che puoi usare con Podman, vedi Comandi Docker.

• sudo podman images - Elencare tutti i contenitori in esecuzione.
• sudo podman stats - Visualizza l'utilizzo della CPU del contenitore, l'utilizzo MEM, la rete e l'I/O a blocchi.
• sudo podman port mstunnel-server- Elencare i mapping delle porte dal tunnel-server all'host Linux locale.

Comandi di Linux

Di seguito sono riportati i comandi Linux comuni che è possibile utilizzare con un server tunnel.

• sudo su – Ti fa fare il tifo sulla scatola. Usare questo comando prima di eseguire i comandi seguenti e prima di eseguire mstunnel-setup.

• ls – elenca i contenuti della directory.

• ls – l – Elenca il contenuto della directory inclusi i timestamp.

• cd : passare a un'altra directory. Ad esempio, cd /etc/test/stuff ti cambia dalla directory principale alla sottocartella >etc alla sottocartella >test e quindi alla cartella stuff.

• cp <source> <destination> - Utile per copiare i certificati nella posizione corretta.

• ln –s <source> <target> - Crea un softlink.

• curl <URL> – Controlla l'accesso a un sito web. Ad esempio: curl https://microsoft.com

• ./<filename> - Esegui uno script.

Caricare manualmente ip_tables

Usa i seguenti comandi per verificare e, se necessario ip_tables, caricarli manualmente nel kernel del server Linux. Usa il contesto sudo:

• Verificare la presenza di ip_tables nel server: lsmod |grep ip_tables
• Crea un file di configurazione che carichi il ip_tables nel kernel all'avvio del server: echo ip_tables > /etc/modules-load.d/mstunnel_iptables.conf
• Per caricare immediatamente ip_tables nel kernel: /sbin/modprobe ip_tables