Ρύθμιση παραμέτρων ασφάλειας καναλιών Web και Direct Line

Όταν δημιουργείτε έναν Copilot Studio πράκτορα, όποιος γνωρίζει το αναγνωριστικό πράκτορα μπορεί να αποκτήσει αμέσως πρόσβαση στον πράκτορα μέσω της τοποθεσίας web Demo και Προσαρμοσμένων τοποθεσιών web καναλιών. Αυτά τα κανάλια είναι διαθέσιμα από προεπιλογή, ενώ δεν απαιτείται ρύθμιση παραμέτρων.

Για την εφαρμογή Microsoft Teams, μπορείτε να ρυθμίσετε τις παραμέτρους των σύνθετων επιλογών ασφαλείας καναλιού web.

Σημείωμα

Εάν έχετε άδεια χρήσης μόνο για το Teams, δεν μπορείτε να δημιουργήσετε μυστικά για να ενεργοποιήσετε την ασφαλή πρόσβαση. Τα διακριτικά ασφαλούς πρόσβασης δημιουργούνται αυτόματα για εσάς και η ασφαλής πρόσβαση είναι ενεργοποιημένη από προεπιλογή.

Οι χρήστες μπορούν να βρουν το ID πράκτορα απευθείας από το Copilot Studio ή λαμβάνοντάς το από κάποιον. Ωστόσο, ανάλογα με τη δυνατότητα και την ευαισθησία του παράγοντα, αυτή η πρόσβαση μπορεί να μην είναι επιθυμητή.

Χρησιμοποιώντας την ασφάλεια που βασίζεται σε Direct Line, μπορείτε να ενεργοποιήσετε την πρόσβαση μόνο σε τοποθεσίες που ελέγχετε, ενεργοποιώντας την ασφαλή πρόσβαση με μυστικούς Direct Line ή διακριτικά.

Επίσης, μπορείτε να προσθέσετε και να δημιουργήσετε ξανά μυστικά και να ανανεώσετε διακριτικά, καθώς και να απενεργοποιήσετε εύκολα την ασφαλή πρόσβαση σε περίπτωση που δεν θέλετε να τη χρησιμοποιήσετε πλέον.

Σημείωμα

Το Copilot Studio χρησιμοποιεί το Bot Framework Direct Line κανάλι για να συνδέσει την ιστοσελίδα ή την εφαρμογή σας στον παράγοντα.

Ενεργοποίηση ή απενεργοποίηση ασφάλειας καναλιού web

Μπορείτε να χρησιμοποιήσετε μυστικά και διακριτικά για κάθε παράγοντα.

Όταν ενεργοποιείτε αυτήν την επιλογή, τα κανάλια πρέπει το πρόγραμμα-πελάτης να ελέγχει την ταυτότητά του χρησιμοποιώντας έναν μυστικό κωδικό ή χρησιμοποιώντας ένα διακριτικό που δημιουργείται χρησιμοποιώντας τον μυστικό κωδικό, ο οποίος λαμβάνεται κατά τον χρόνο εκτέλεσης.

Προσπαθεί να αποκτήσει πρόσβαση στον παράγοντα που δεν παρέχουν αυτό το μέτρο ασφαλείας δεν λειτουργεί.

  1. Μεταβείτε στη σελίδα Ρυθμίσεις για τον πράκτορά σας, επιλέξτε Ασφάλεια και, στη συνέχεια, επιλέξτε Ασφάλεια καναλιού Web.

Στιγμιότυπο οθόνης της ασφάλειας του καναλιού Web που επισημαίνεται στο αναδυόμενο στοιχείο Ρυθμίσεις.

  1. Ενεργοποιήστε την επιλογή Να απαιτείται ασφαλής πρόσβαση.

Προειδοποίηση

Όταν ενεργοποιείτε ή απενεργοποιείτε την επιλογή Να απαιτείται ασφαλής πρόσβαση, μπορεί να χρειαστούν έως και δύο ώρες για να μεταδοθούν οι ρυθμίσεις από το σύστημα και να τεθεί σε ισχύ. Μέχρι τότε, η προηγούμενη ρύθμιση είναι σε ισχύ. Δεν χρειάζεται να δημοσιεύσετε τον παράγοντα για να εφαρμοστεί αυτή η αλλαγή.

Σχεδιάστε εκ των προτέρων για να αποφύγετε την αποκάλυψη του πράκτορά σας ακούσια.

Εάν χρειαστεί να απενεργοποιήσετε την επιλογή ασφάλειας του καναλιού web, μπορείτε να το κάνετε καθαρίζοντας το κουμπί εναλλαγής Να απαιτείται ασφαλής πρόσβαση . Η απενεργοποίηση της ασφαλούς πρόσβασης μπορεί να διαρκέσει έως και δύο ώρες για να τεθεί σε ισχύ.

Στιγμιότυπο οθόνης ενός μηνύματος επιβεβαίωσης κατά την απενεργοποίηση της ασφαλούς πρόσβασης, το οποίο αναφέρει ότι αυτή η ενέργεια καθιστά την τοποθεσία web του Demo και οποιοδήποτε κανάλι Direct Line που δεν χρησιμοποιεί μυστικό ή διακριτικό διαθέσιμο. Αυτή η ενέργεια μπορεί να διαρκέσει έως και δύο ώρες για να τεθεί σε ισχύ.

Χρήση μυστικών ή διακριτικών

Εάν δημιουργείτε μια εφαρμογή "υπηρεσία προς υπηρεσία", ο καθορισμός του μυστικού στα αιτήματα κεφαλίδας ελέγχου ταυτότητας μπορεί να είναι η πιο απλή προσέγγιση.

Αν συντάσσετε μια εφαρμογή, όπου το πρόγραμμα-πελάτης εκτελείται σε μια εφαρμογή προγράμματος περιήγησης στο Web ή για κινητές συσκευές ή ο κώδικας μπορεί να είναι ορατός στους πελάτες, πρέπει να ανταλλάξετε το μυστικό σας με ένα διακριτικό. Εάν δεν χρησιμοποιήσετε διακριτικό, μπορεί να παραβιαστεί το μυστικό σας. Όταν ζητάτε ένα διακριτικό στην υπηρεσία σας, καθορίστε το μυστικό στην κεφαλίδα ελέγχου ταυτότητας.

Τα διακριτικά λειτουργούν μόνο για μία συνομιλία και λήγουν εκτός αν ανανεωθούν.

Επιλέξτε το μοντέλο ασφαλείας που ταιριάζει καλύτερα στην κατάστασή σας.

Προειδοποίηση

Μην εκθέτετε τον μυστικό κωδικό σε οποιονδήποτε κώδικα που εκτελείται στο πρόγραμμα περιήγησης, είτε μέσω κώδικα είτε μέσω μιας κλήσης δικτύου.

Η απόκτηση του διακριτικού χρησιμοποιώντας τον μυστικό κωδικό στον κωδικό υπηρεσίας σας είναι ο πιο ασφαλής τρόπος για την προστασία του παράγοντα Copilot Studio σας.

Λήψη μυστικών

Χρειάζεστε το μυστικό ώστε να μπορέσετε να το καθορίσετε στα αιτήματα κεφαλίδας ελέγχου ταυτότητας της εφαρμογής σας ή σε παρόμοια κατάσταση.

  1. Στο μενού πλοήγησης, στις Ρυθμίσεις επιλέξτε Ασφάλεια. Στη συνέχεια, επιλέξτε το πλακίδιο ασφαλείας καναλιών Web.

  2. Επιλέξτε Αντιγραφή για το Μυστικό 1 ή το Μυστικό 2 ώστε να αντιγραφεί στο πρόχειρο. Επιλέξτε το εικονίδιο ορατότητας για να αποκαλύψετε τον μυστικό κωδικό. Εμφανίζεται μια προτροπή προειδοποίησης προτού αποκαλυφθεί.

Εναλλαγή μυστικών

Εάν χρειαστεί να αλλάξετε τον μυστικό κωδικό που χρησιμοποιεί ο πράκτοράς σας, μπορείτε να τον αλλάξετε χωρίς χρόνο εκτός λειτουργίας ή διακοπή.

Το Copilot Studio σάς παρέχει δύο μυστικά, τα οποία λειτουργούν ταυτόχρονα. Μπορείτε να αλλάξετε τον μυστικό κωδικό που χρησιμοποιεί ο ατζέντης σας με τον άλλο. Μετά την ανταλλαγή των μυστικών σας και οι χρήστες σας συνδέονται χρησιμοποιώντας το νέο μυστικό, μπορείτε να αναδημιουργήσετε τον μυστικό κωδικό.

Επαναδημιουργία μυστικού κωδικού

Για να δημιουργήσετε ξανά ένα μυστικό, επιλέξτε Επαναδημιουργία δίπλα στο μυστικό.

Προειδοποίηση

Το προφίλ χρήστη που συνδέεται χρησιμοποιώντας τον αρχικό μυστικό κωδικό ή ένα διακριτικό που λαμβάνεται από αυτόν τον μυστικό κωδικό αποσυνδέεται.

Δημιουργία διακριτικού

Μπορείτε να δημιουργήσετε ένα διακριτικό που χρησιμοποιείτε κατά την έναρξη μιας συνομιλίας με έναν μόνο παράγοντα. Για περισσότερες πληροφορίες, ανατρέξτε στην ενότητα Λήψη διακριτικού Direct Line στο Δημοσίευση παράγοντα σε κινητές συσκευές ή προσαρμοσμένες εφαρμογές.

  1. Λήψη του μυστικού.

  2. Στον κωδικό υπηρεσίας, στείλτε την ακόλουθη αίτηση για να ανταλλάξετε τον μυστικό κωδικό με ένα διακριτικό. Αντικαταστήστε το <SECRET> με την τιμή του μυστικού που αποκτήθηκε στο Βήμα 1.

    POST https://directline.botframework.com/v3/directline/tokens/generate
    Authorization: Bearer <SECRET>
    

Τα παρακάτω δείγματα κώδικα παρέχουν παραδείγματα του αιτήματος δημιουργίας διακριτικού και της απόκρισής του.

Δείγμα αίτησης δημιουργίας διακριτικού

POST https://directline.botframework.com/v3/directline/tokens/generate
Authorization: Bearer RCurR_XV9ZA.cwA.BKA.iaJrC8xpy8qbOF5xnR2vtCX7CZj0LdjAPGfiCpg4Fv0

Δείγμα απόκρισης δημιουργίας διακριτικού

HTTP/1.1 200 OK
[other headers]
{
  "conversationId": "abc123",
  "token": "RCurR_XV9ZA.cwA.BKA.iaJrC8xpy8qbOF5xnR2vtCX7CZj0LdjAPGfiCpg4Fv0y8qbOF5xPGfiCpg4Fv0y8qqbOF5x8qbOF5xn",
  "expires_in": 1800
}

Εάν η αίτηση είναι επιτυχής, η απόκριση περιέχει ένα διακριτικό που είναι έγκυρο για μία συνομιλία και μια τιμή expires_in που υποδεικνύει τον αριθμό των δευτερολέπτων έως ότου λήξει το διακριτικό.

Για να διατηρήσετε χρήσιμο το διακριτικό, πρέπει να ανανεώσετε το διακριτικό προτού λήξει.

Ανανέωση διακριτικού

Μπορείτε να ανανεώσετε ένα διακριτικό απεριόριστο αριθμό φορών, εφόσον δεν έχει λήξει.

Δεν μπορείτε να ανανεώσετε ένα διακριτικό που έχει λήξει.

Για να ανανεώσετε ένα διακριτικό, στείλτε την ακόλουθη αίτηση και αντικαταστήστε <TOKEN TO BE REFRESHED> με το διακριτικό που θέλετε να ανανεώσετε.

POST https://directline.botframework.com/v3/directline/tokens/refresh
Authorization: Bearer <TOKEN TO BE REFRESHED>

Τα παρακάτω δείγματα κώδικα παρέχουν παραδείγματα του αιτήματος ανανέωσης διακριτικού και της απόκρισής του.

Δείγμα αίτησης ανανέωσης

POST https://directline.botframework.com/v3/directline/tokens/refresh
Authorization: Bearer CurR_XV9ZA.cwA.BKA.iaJrC8xpy8qbOF5xnR2vtCX7CZj0LdjAPGfiCpg4Fv0y8qbOF5xPGfiCpg4Fv0y8qqbOF5x8qbOF5xn

Δείγμα απόκρισης ανανέωσης

Εάν η αίτηση είναι επιτυχής, η απόκριση περιέχει ένα νέο διακριτικό που είναι έγκυρο για την ίδια συνομιλία με το προηγούμενο διακριτικό και μια τιμή expires_in που υποδεικνύει τον αριθμό των δευτερολέπτων έως ότου λήξει το νέο διακριτικό.

Για να διατηρήσετε χρήσιμο το νέο διακριτικό, ανανεώστε ξανά το διακριτικό προτού λήξει.

HTTP/1.1 200 OK
[other headers]
{
  "conversationId": "abc123",
  "token": "RCurR_XV9ZA.cwA.BKA.y8qbOF5xPGfiCpg4Fv0y8qqbOF5x8qbOF5xniaJrC8xpy8qbOF5xnR2vtCX7CZj0LdjAPGfiCpg4Fv0",
  "expires_in": 1800
}

Για περισσότερες πληροφορίες σχετικά με την ανανέωση ενός διακριτικού, ανατρέξτε στην ενότητα Ανανέωση διακριτικού Direct Line στο API Direct Line - Έλεγχος ταυτότητας.