Lợi ích khi kết nối
Việc kết nối tài khoản Azure Static Web Apps của riêng bạn cho phép bạn xuất bản một trang web tĩnh lên tài khoản Azure Static Web Apps của bạn từ bảng điều khiển Zinn®. Bạn sở hữu dự án và chịu chi phí; chúng tôi đảm nhận việc triển khai, tên miền tùy chỉnh và các bản ghi DNS.
Trước khi bắt đầu
Một gói đăng ký Azure, một nhóm tài nguyên dành cho các trang web và một tài khoản GitHub, GitLab hoặc Bitbucket đã kết nối chứa mã nguồn — Azure Static Web Apps xây dựng từ một kho lưu trữ. Gói miễn phí của Azure cho phép sử dụng cho mục đích thương mại và hai tên miền tùy chỉnh cho mỗi ứng dụng.
1. Tạo khóa tại Azure Static Web Apps
Azure gọi đây là một service principal. Trong trung tâm quản trị Microsoft Entra, hãy mở Entra ID → App registrations → New registration, đặt tên và nhấn Register. Trên trang tổng quan của ứng dụng, hãy sao chép Application (client) ID và Directory (tenant) ID. Sau đó mở Certificates & secrets → Client secrets → New client secret, chọn thời hạn và nhấn Add — hãy sao chép giá trị bí mật ngay lập tức, Azure chỉ hiển thị nó một lần.
Trong cổng thông tin Azure, mở nhóm tài nguyên bạn muốn chúng tôi sử dụng, sau đó chọn Access control (IAM) → Add → Add role assignment. Chọn vai trò Contributor, gán cho User, group, or service principal, tìm kiếm ứng dụng theo tên và nhấn Review + assign. Hãy ghi lại tên của nhóm tài nguyên và Subscription ID mà nó thuộc về (tìm kiếm Subscriptions trong cổng thông tin).
2. Kết nối tại đây
Mở mục Integrations trong bảng điều khiển của bạn và chọn Connect an account. Chọn Static hosting (Netlify, Vercel) làm nhóm và Azure Static Web Apps làm tài khoản, điền Client ID, Client secret, Tenant ID, Subscription ID cùng Resource group, rồi nhấn Connect account.
Chúng tôi kiểm tra nội dung bạn dán trước khi lưu bất kỳ thông tin nào. Khóa không hoạt động sẽ không bao giờ được lưu trữ, và phản hồi sẽ cho biết khóa đó gặp lỗi gì. Khóa hoạt động sẽ được mã hóa và lưu trữ trong kho bí mật của chúng tôi — không bao giờ nằm trong cơ sở dữ liệu của chúng tôi — và sẽ không bao giờ hiển thị lại, kể cả với bạn.
Điều gì xảy ra tiếp theo
- Khi bạn tạo hoặc chuyển một trang web tĩnh, tài khoản này sẽ xuất hiện dưới dạng một đích triển khai. Azure Static Web Apps xây dựng từ một kho lưu trữ — dịch vụ này không chấp nhận bản dựng tải lên trực tiếp — vì vậy mã nguồn của trang web phải đến từ một kho lưu trữ GitHub, GitLab hoặc Bitbucket đã kết nối. Hãy kết nối một kho lưu trữ trước nếu bạn chưa thực hiện.
- Chúng tôi tạo dịch vụ trên tài khoản của bạn, trỏ dịch vụ vào kho lưu trữ, gắn tên miền tùy chỉnh của bạn và kích hoạt các lần triển khai. Trang của tên miền sẽ hiển thị mọi bản ghi DNS mà Azure Static Web Apps cần.
- Mức sử dụng và thanh toán nằm trên tài khoản của bạn, hiển thị trong bảng điều khiển của nhà cung cấp của chính bạn.
- Tên miền apex được xác minh bằng bản ghi TXT và miền phụ bằng bản ghi CNAME của nó; trang của tên miền sẽ hiển thị bản ghi nào mà tên miền của bạn cần.
Nếu không kết nối được
Azure đã từ chối service principal. Hoặc là client secret đã hết hạn — chúng luôn hết hạn theo thời hạn bạn đã chọn — hoặc ứng dụng không còn quyền Contributor trên nhóm tài nguyên. Hai thông báo này trông giống nhau, vì vậy hãy kiểm tra việc phân quyền trước khi tạo secret mới.
Không tìm thấy thông tin nào. Hãy kiểm tra xem Subscription ID và Resource group có đúng là những mục bạn đã gán vai trò hay không, và Tenant ID có phải là thư mục mà ứng dụng được đăng ký hay không.
Hệ thống báo khóa bị từ chối. Gần như luôn là một trong ba nguyên nhân: một khoảng trắng hoặc dấu ngắt dòng bị sao chép cùng, khóa đã hết hạn, hoặc khóa đã bị thu hồi hoặc tạo lại sau khi bạn sao chép. Hãy tạo một khóa mới và dán lại.
Kết nối thành công nhưng thao tác sau đó thất bại. Khóa đã xác thực nhưng thiếu quyền mà hành động đó yêu cầu. Hãy tạo một khóa mới với các quyền được liệt kê ở trên, sau đó ngắt kết nối cũ và kết nối khóa mới.
Ngắt kết nối
Mở mục Integrations, tìm tài khoản và nhấn Disconnect. Thao tác này sẽ xóa ngay lập tức khóa đã lưu trữ. Bất kỳ dịch vụ nào đang sử dụng khóa sẽ dừng lại ở hành động tiếp theo, và các màn hình phụ thuộc vào nó sẽ thông báo điều đó thay vì âm thầm gặp lỗi.
Việc ngắt kết nối không hoàn tác những gì đã được thực hiện — các bản ghi, bản triển khai hoặc cài đặt mà chúng tôi đã thay đổi trên tài khoản của bạn vẫn được giữ nguyên. Nếu bạn cho rằng chính khóa đó có thể đã bị lộ, hãy thu hồi nó tại nhà cung cấp; việc ngắt kết nối chỉ xóa bản sao của chúng tôi, không phải của họ.