L'obiettivo di questo documento è che un'icona appaia bloccata nella barra di spostamento dell'app di Microsoft Teams per un sito di SharePoint che vogliamo sia disponibile per tutti gli utenti di Teams o persone specifiche. Non importa se sono membri di qualsiasi Team o Canale. La soluzione fornirà ai nuovi utenti l'accesso al portale del cliente per la formazione dei team prima che si uniscano o creino il loro primo Team.
1 Controlli dell'app Teams nella Console di amministrazione
2 Controllare chi può caricare app personalizzate
3 Verifica delle politiche applicate a un utente
4 Controllo delle autorizzazioni per le app Teams
5 Creazione dell'app
6 Testare l'app
7 Imballaggio dell'app
8 Caricamento dell'app
9 Rendere disponibile l'app
10 Soluzione finale
Controlli dell'app Teams nella Console di amministrazione
Le app visualizzate nella barra delle app di Teams sono controllate dalla Console di amministrazione di Teams nel tenant. App Teams > Criteri di configurazione.
Attenzione ! Non preparare adeguatamente il tenant in anticipo per il caricamento di un'app personalizzata comporterà il seguente messaggio più avanti in questo documento.
Attenzione ! Non preparare il tenant per consentire solo a determinate persone di caricare app personalizzate consentirà a tutti di caricare app nel tuo app store.
Controllare chi può caricare app personalizzate
- Nella pagina dei criteri di configurazione dell'app crea un nuovo criterio personalizzato.
Abbiamo scelto il nome " Politica di caricamento dell'app " ma tutti voi potete usare ciò che ha senso. Nel nuovo criterio, attiva " ON " la possibilità di caricare app personalizzate se il tuo ID utente è assegnato a questo criterio.
- Ignora tutte le altre impostazioni e fai clic su " Salva "
- Nella schermata della politica selezionare la nuova politica e fare clic su " Gestisci utenti "
- Nella pagina Utenti gestiti, digitare i nomi degli utenti a cui si desidera assegnare questo criterio.
- Tutti gli utenti che non fanno parte di questa norma riceveranno il seguente errore durante il tentativo di caricare un'app.
Attenzione ! Dopo aver salvato queste impostazioni dei criteri possono essere necessarie ore prima che diventino effettive.
Verifica quali criteri vengono applicati a un utente
- Passare alla scheda " Utenti " nell'interfaccia di amministrazione di Teams
- Cerca un utente a cui hai appena applicato il criterio nel passaggio precedente, quindi seleziona la casella accanto all'utente. Ciò ti consentirà di vedere quante politiche si applicano a questo utente.
- È quindi possibile selezionare l'opzione " Modifica impostazioni " per modificare le impostazioni dei criteri dell'utente.
- Individua l' opzione " Politica di configurazione dell'app " e fai clic sul menu a discesa.
- Vedrai tutti i criteri di configurazione dell'app correnti che controllano l'accesso di questo utente a Teams Apps.
Controllo delle autorizzazioni per le app Teams
- Nella Console di amministrazione di Teams, cerca la scheda " Criteri di autorizzazione " in " App Teams "
- Fai clic sul pulsante " Impostazioni app a livello di organizzazione " per verificare le autorizzazioni correnti per utilizzare le app Teams nel tenant.
Attenzione ! Se l'amministratore del tenant ha impostato le seguenti opzioni in verde su " Off ", non è possibile completare correttamente questa missione dei documenti di aggiunta e utilizzo di un'app personalizzata in Teams.
- Successivamente, dobbiamo controllare l'autorizzazione dell'app a livello di criteri se le impostazioni precedenti sembravano essere attive.
- In " Politiche di autorizzazione app " seleziona il " Criterio globale (predefinito a livello di organizzazione) per le impostazioni controllando il criterio e facendo clic su " Modifica "
- Lo scenario migliore è che la casella in verde sia impostata su tutte le app e gli utenti siano al di sotto di questo criterio. È l'impostazione predefinita e nessun altro criterio li limita da queste impostazioni.
Avvertimento! Se l'amministratore ha modificato l'autorizzazione delle app predefinite in qualcosa di diverso da " Consenti tutte le app ", dovremo autorizzare la nostra app personalizzata alla fine di questo documento e l'app " Teams Apps Studio " dall'inizio per consentirne la visualizzazione da parte di gli utenti in Teams.
- A questo punto la nostra app del portale non è stata creata, quindi non possiamo inserire nella whitelist finché non completiamo i passaggi in questo documento e carichiamo l'app personalizzata nel catalogo delle app tenant.
- Assicurati di salvare tutte le modifiche apportate e concedi tempo affinché le modifiche alle politiche diventino effettive.
Creazione dell'app
Ora che abbiamo preparato i nostri criteri per app e autorizzazioni, siamo pronti per creare l'app personalizzata per visualizzare l'icona collegata al nostro portale di SharePoint nella barra di spostamento delle app di Teams.
- Accedi alla versione Web di Teams o alla versione desktop come utente aggiunto alla " Politica di caricamento dell'app "
- In Teams, fai clic sull'icona dell'App Store nella barra di navigazione dell'app a sinistra di Teams.
- Quando il negozio si apre, digita " App Studio " per individuare l'app che dobbiamo installare affinché questo utente crei la nostra app personalizzata.
- Fare clic sul pulsante " Aggiungi " per installare l'app
- Dopo l'apertura dell'app App Studio, fai clic su " Editor manifest "
- Nella scheda dell'editor manifest cerca " Crea una nuova app "
- Successivamente, vedrai la seguente schermata con molti campi che dobbiamo completare. Li prenderemo una sezione alla volta.
- Dettagli app Attenzione ! Non inserire " Microsoft " nella denominazione. Se il " Nome breve " è troppo lungo, verrà troncato e mostrerà un'ellisse accanto al nome.
Nella sezione di identificazione, devi fare clic sul pulsante " Genera " per generare una chiave univoca per questa app. È necessario compilare il " Nome del pacchetto ". Puoi usare qualsiasi nome semplicemente seguendo il formato mostrato sopra. Anche la “ Versione ” deve essere impostata.
- Descrizione Attenzione ! Non inserire " Microsoft " nella denominazione
- Informazioni sullo sviluppatore
Le informazioni sullo sviluppatore identificano solo chi ha creato l'app e un sito Web per scoprire di più sullo sviluppatore. Suggerirei di collegarsi a una pagina che le persone possono scoprire di più sullo sviluppo e lo scopo dell'app. In questo esempio, si rimanda al sito di SharePoint che avvia il sito Percorsi di apprendimento in un tenant.
L'URL dell'" Informativa sulla privacy " punta all'informativa sulla privacy di Microsoft poiché questo esempio utilizza il portale Microsoft Learning Pathways. I " Termini di utilizzo " puntano solo alla documentazione per il portale dei percorsi di apprendimento. Si raccomanda che questi URL non puntino a siti ospitati esternamente. Durante il nostro test di questa app in seguito vedremo i seguenti avvisi.
Avrai bisogno di almeno due loghi dalla pagina di branding. Devono essere delle dimensioni esatte elencate nella loro descrizione. Ora hai completato tutte le opzioni nella scheda " Dettagli app ". Ora vai alla scheda " Schede " in " Capacità ".
- Fare clic su " Aggiungi una scheda personale "
- Nella scheda Nome, scegli un nome che verrà visualizzato nella pagina Web del portale come mostrato di seguito.
- Impostare qualsiasi numero l'ID entità.
- L'" URL del contenuto " che abbiamo rimanda al nostro portale Percorsi di apprendimento.
- L'“ URL del sito web ” che abbiamo rimandato al nostro portale Percorsi di apprendimento Fare clic su Salva.
- Accesso singolo all'app Web
- L'ID applicazione AAD in questo esempio è per un sito di SharePoint. Il numero ufficiale è 00000003-0000-0ff1-ce00-000000000000 non utilizzare nessun altro numero per questo esempio.
- L'" URL della risorsa " deve avere il nome univoco del tenant al posto del mio " m365x360288 ". Premi Salva dopo aver completato i campi.
- Ora abbiamo completato la configurazione della nostra app personalizzata.
Testare l'app
- Sotto l'intestazione " Fine " nell'app App Studio seleziona " Testa e distribuisci "
- Successivamente, vedrai la seguente schermata con una serie di avvisi. Non preoccuparti degli avvisi in questo caso d'uso di esempio. In un ambiente di produzione, dovresti seguire la guida per portarli su URL interni.
- Se non sei riuscito a inserire le cose correttamente, vedrai il seguente avviso.
- Se hai fatto tutto bene, il programma di installazione dell'app apparirà pronto per essere testato. Aggiungilo ai tuoi team. Prima di fare clic su Aggiungi, rivedere le informazioni su . Vedrai come sono state utilizzate le informazioni dall'alto.
- Dopo l'installazione dell'app, se funziona, caricherà il portale dei percorsi di apprendimento.
Imballaggio dell'app
- Torna all'app App Studio facendo clic sull'ellisse nella barra di navigazione dell'app.
- Si aprirà la finestra seguente che mostra l'app " App Studio " e l'app " Contoso Learning " che abbiamo appena testato e aggiunta al nostro team di utenti. Fare clic sull'icona " App Studio " per riavviare l'app. Seleziona " Editor manifest "
- Cerca in " App create di recente " l'app " Contoso Learning " e fai clic su di essa.
- Fare clic sulla scheda " Testa e distribuisci ".
- Fare clic sul pulsante " Download " per impacchettare l'app per l'importazione.
- Vedrai un pop-up che indica che il pacchetto è stato esportato e il suo nome file.
- La posizione sarà la cartella dei download sul PC. Ricorda quella posizione per il caricamento nel portale dell'app tenant.
Caricamento dell'app
- Torna in Teams e cerca l'icona " App " nella barra di navigazione dell'app
- Se il tuo ID utente dispone dell'autorizzazione corretta concessa per caricare un'app personalizzata, puoi fare clic su " Carica un'app personalizzata " in fondo all'elenco. Cliccaci sopra. Quindi fai clic per caricare sul tuo Tenant. Non sono sicuro del motivo per cui è un doppio clic Passare alla cartella dei download per individuare il nostro pacchetto e fare clic su " Apri "
- Se non sei riuscito a utilizzare un account che è nella " Politica di caricamento dell'app " che abbiamo creato, vedrai il seguente errore.
- In caso di esito positivo, l'app verrà ora visualizzata nel catalogo app tenant
- Se si cerca questa app nel catalogo delle app e si fa clic su Aggiungi, l'app verrà installata sotto l'ellisse come durante l'installazione di prova. FERMARE! Non installeremo l'app in questo modo. Invece, aggiungeremo l'app alla barra di navigazione dell'app utilizzando la nostra " Politica di configurazione dell'app ".
Rendere disponibile l'App
- Individua la politica di configurazione dell'app che abbiamo creato in precedenza e seleziona la casella. Quindi fare clic su " Modifica "
- In " App bloccate " fai clic su " Aggiungi app "
- Cerca l'app " Apprendimento " e selezionala e fai clic su " Aggiungi ", quindi fai clic sul pulsante " Aggiungi " in basso per chiudere lo schermo.
- Ora vedrai l'app su come apparirò sulla barra di navigazione dell'app. L'impostazione predefinita è in basso puoi evidenziare l'app e spostarla verso l'alto. Se sei soddisfatto della posizione clicca su “ Salva ”
Soluzione finale
- Ora attendiamo la sincronizzazione delle impostazioni dei criteri sui sistemi back-end di Microsoft 365 prima di vedere i risultati del nostro lavoro. Non vedremo la nostra nuova app mostrata sulla barra di navigazione dell'app per circa 2 ore.
- Fare clic sull'icona Nuova app e vedere il progetto finito.