Τι σας προσφέρει η σύνδεσή του
Η σύνδεση του δικού σας λογαριασμού Azure Static Web Apps σας επιτρέπει να δημοσιεύετε έναν στατικό ιστότοπο στον δικό σας λογαριασμό Azure Static Web Apps μέσα από τον πίνακα ελέγχου σας στο Zinn®. Το έργο και η χρέωση ανήκουν σε εσάς· εμείς διαχειριζόμαστε την ανάπτυξη, τον προσαρμοσμένο τομέα και τις εγγραφές DNS.
Πριν ξεκινήσετε
Μια συνδρομή Azure, μια ομάδα πόρων (resource group) για τους ιστότοπους, και ένας συνδεδεμένος λογαριασμός GitHub, GitLab ή Bitbucket που περιέχει τον κώδικα — το Azure Static Web Apps δημιουργεί εκδόσεις (builds) από ένα αποθετήριο. Το δωρεάν πρόγραμμα του Azure επιτρέπει την εμπορική χρήση και δύο προσαρμοσμένους τομείς ανά εφαρμογή.
1. Δημιουργήστε το κλειδί στο Azure Static Web Apps
Το Azure το ονομάζει αυτό service principal. Στο κέντρο διαχείρισης Microsoft Entra ανοίξτε το Entra ID → App registrations → New registration, δώστε του ένα όνομα και κάντε κλικ στο Register. Στη σελίδα επισκόπησης της εφαρμογής αντιγράψτε το Application (client) ID και το Directory (tenant) ID. Στη συνέχεια ανοίξτε το Certificates & secrets → Client secrets → New client secret, επιλέξτε μια διάρκεια και κάντε κλικ στο Add — αντιγράψτε την τιμή του μυστικού (secret) αμέσως, καθώς το Azure την εμφανίζει μόνο μία φορά.
Στην πύλη του Azure, ανοίξτε την ομάδα πόρων που θέλετε να χρησιμοποιήσουμε, και μετά Access control (IAM) → Add → Add role assignment. Επιλέξτε τον ρόλο Contributor, αντιστοιχίστε τον σε User, group, or service principal, αναζητήστε την εφαρμογή με βάση το όνομα, και κάντε κλικ στο Review + assign. Σημειώστε το όνομα της ομάδας πόρων και το Subscription ID στο οποίο ανήκει (αναζητήστε Subscriptions στην πύλη).
2. Συνδέστε το εδώ
Ανοίξτε τις Ενσωματώσεις στον πίνακα ελέγχου σας και επιλέξτε Σύνδεση λογαριασμού. Επιλέξτε Static hosting (Netlify, Vercel) ως ομάδα και Azure Static Web Apps ως λογαριασμό, συμπληρώστε τα Client ID, Client secret, Tenant ID, Subscription ID και Resource group, και πατήστε Σύνδεση λογαριασμού.
Δοκιμάζουμε ό,τι επικολλάτε πριν αποθηκευτεί οτιδήποτε. Ένα κλειδί που δεν λειτουργεί δεν αποθηκεύεται ποτέ, και η απάντηση αναφέρει τι πήγε στραβά με αυτό. Ένα κλειδί που λειτουργεί διατηρείται κρυπτογραφημένο στο ασφαλές θησαυροφυλάκιό μας (secrets vault) — ποτέ στη βάση δεδομένων μας — και δεν εμφανίζεται ποτέ ξανά, ούτε καν σε εσάς.
Τι συμβαίνει στη συνέχεια
- Όταν δημιουργείτε ή μεταφέρετε έναν στατικό ιστότοπο, αυτός ο λογαριασμός εμφανίζεται ως προορισμός
ανάπτυξης. Το Azure Static Web Apps δημιουργεί εκδόσεις από ένα αποθετήριο — δεν έχει τρόπο να δεχτεί ένα μεταφορτωμένο build — επομένως ο κώδικας του ιστότοπου πρέπει να προέρχεται από ένα συνδεδεμένο αποθετήριο GitHub, GitLab ή Bitbucket. Συνδέστε ένα πρώτα, εάν δεν το έχετε κάνει ήδη.
- Δημιουργούμε την υπηρεσία στον λογαριασμό σας, την κατευθύνουμε στο αποθετήριο, προσαρτούμε τον προσαρμοσμένο τομέα σας
και εκκινούμε αναπτύξεις. Η σελίδα του τομέα εμφανίζει κάθε εγγραφή DNS που χρειάζεται το Azure Static Web Apps.
- Η χρήση και η τιμολόγηση βρίσκονται στον λογαριασμό σας, ορατές στον δικό σας πίνακα ελέγχου παρόχου.
- Ένας τομέας apex επαληθεύεται από μια εγγραφή TXT και ένας υποτομέας από το CNAME του· η σελίδα του τομέα εμφανίζει
ποιο από τα δύο χρειάζεται ο τομέας σας.
Εάν δεν συνδέεται
Το Azure απέρριψε το service principal. Είτε το client secret έχει λήξει — πάντα λήγουν, με βάση τη διάρκεια που επιλέξατε — είτε η εφαρμογή δεν έχει πλέον δικαίωμα Contributor στην ομάδα πόρων. Τα δύο μηνύματα μοιάζουν, επομένως ελέγξτε την ανάθεση ρόλου πριν δημιουργήσετε νέο μυστικό.
Δεν βρέθηκε τίποτα. Βεβαιωθείτε ότι το Subscription ID και το Resource group είναι εκείνα στα οποία αναθέσατε τον ρόλο, και ότι το Tenant ID είναι ο κατάλογος στον οποίο είναι καταχωρημένη η εφαρμογή.
Αναφέρει ότι το κλειδί απορρίφθηκε. Σχεδόν πάντα πρόκειται για ένα από τα εξής τρία: ένα κενό διάστημα ή μια αλλαγή γραμμής που αντιγράφηκε μαζί του, ένα κλειδί που έχει λήξει, ή ένα κλειδί που ανακλήθηκε ή δημιουργήθηκε εκ νέου αφού το αντιγράψατε. Δημιουργήστε ένα νέο και επικολλήστε το ξανά.
Συνδέεται, αλλά κάτι αποτυγχάνει αργότερα. Το κλειδί ταυτοποιείται αλλά δεν διαθέτει ένα δικαίωμα που απαιτείται από την ενέργεια. Δημιουργήστε ένα νέο κλειδί με τα δικαιώματα που αναφέρονται παραπάνω, έπειτα αποσυνδέστε την παλιά σύνδεση και συνδέστε το νέο κλειδί.
Αποσύνδεση
Ανοίξτε τις Ενσωματώσεις, βρείτε τον λογαριασμό και πατήστε Αποσύνδεση. Αυτό διαγράφει το αποθηκευμένο κλειδί αμέσως. Οτιδήποτε το χρησιμοποιούσε σταματά στην επόμενη ενέργειά του, και οι οθόνες που εξαρτώνταν από αυτό το αναφέρουν αντί να αποτυγχάνουν σιωπηρά.
Η αποσύνδεση δεν αναιρεί όσα έχουν ήδη γίνει — οι εγγραφές, οι αναπτύξεις ή οι ρυθμίσεις που αλλάξαμε στον λογαριασμό σας παραμένουν ως έχουν. Εάν πιστεύετε ότι το ίδιο το κλειδί μπορεί να έχει διαρρεύσει, ανακαλέστε το επίσης στον πάροχο· η αποσύνδεση καταργεί το δικό μας αντίγραφο, όχι το δικό τους.