Faida za kuiunganisha kwako
Kuunganisha akaunti yako mwenyewe ya Azure Static Web Apps kunakuruhusu kuchapisha tovuti tuli kwenye akaunti yako ya Azure Static Web Apps kutoka kwenye dashibodi yako ya Zinn®. Mradi na bili ni vyako; sisi tunashughulikia usambazaji, kikoa maalum na rekodi za DNS.
Kabla ya kuanza
Usajili wa Azure, kikundi cha rasilimali (resource group) kwa ajili ya tovuti, na akaunti iliyounganishwa ya GitHub, GitLab au Bitbucket yenye msimbo — Azure Static Web Apps huunda tovuti kutoka kwenye hifadhi ya msimbo (repository). Mpango wa bure wa Azure unaruhusu matumizi ya kibiashara na vikoa viwili maalum kwa kila programu.
1. Unda ufunguo kwenye Azure Static Web Apps
Azure huita hii service principal. Katika kituo cha usimamizi cha Microsoft Entra fungua Entra ID → App registrations → New registration, ipe jina kisha Register. Kwenye ukurasa wa muhtasari wa programu, nakili Application (client) ID na Directory (tenant) ID. Kisha fungua Certificates & secrets → Client secrets → New client secret, chagua muda kisha Add — nakili thamani ya siri hiyo mara moja, Azure huionyesha mara moja tu.
Kwenye lango la Azure (Azure portal), fungua kikundi cha rasilimali unachotaka tutumie, kisha Access control (IAM) → Add → Add role assignment. Chagua jukumu la Contributor, likabidhi kwa User, group, or service principal, tafuta programu hiyo kwa jina, na Review + assign. Zingatia jina la kikundi cha rasilimali na Subscription ID inakomilikiwa (tafuta Subscriptions kwenye lango).
2. Unganisha hapa
Fungua Integrations kwenye dashibodi yako na uchague Connect an account. Chagua Static hosting (Netlify, Vercel) kama kikundi na Azure Static Web Apps kama akaunti, jaza Client ID, Client secret, Tenant ID, Subscription ID na Resource group, kisha bonyeza Connect account.
Tunajaribu kile unachobandika kabla ya kitu chochote kuhifadhiwa. Ufunguo usiofanya kazi kamwe hauhifadhiwi, na jibu hutaarifu kilichokuwa na hitilafu. Ufunguo unaofanya kazi huwekwa ukiwa umesimbwa kwa njia fiche kwenye ghala letu la siri — kamwe si kwenye hifadhidata yetu — na hauonyeshwi tena kamwe, hata kwako wewe.
Kinachofuata baadaye
- Unapounda au kuhamisha tovuti tuli, akaunti hii huonekana kama lengwa
la usambazaji. Azure Static Web Apps huunda tovuti kutoka kwenye hifadhi ya msimbo — haina njia ya kupokea toleo lililopakiwa — kwa hivyo msimbo wa tovuti lazima utoke kwenye hifadhi ya msimbo ya GitHub, GitLab au Bitbucket iliyounganishwa. Unganisha mojawapo kwanza ikiwa bado hujafanya hivyo.
- Tunaunda huduma kwenye akaunti yako, kuielekeza kwenye hifadhi ya msimbo, kuambatisha kikoa chako maalum
na kuanzisha usambazaji. Ukurasa wa kikoa huonyesha rekodi yoyote ya DNS ambayo Azure Static Web Apps inahitaji.
- Matumizi na malipo viko kwenye akaunti yako, vikionekana kwenye dashibodi ya mtoa huduma wako mwenyewe.
- Kikoa kikuu (apex domain) huthibitishwa kwa rekodi ya TXT na kikoa kidogo (subdomain) kwa CNAME yake; ukurasa wa kikoa huonyesha
ni ipi ambayo kikoa chako kinahitaji.
Isipounganishwa
Azure imekataa service principal. Aidha siri ya mteja (client secret) imeisha muda wake — huwa zinaisha daima, kulingana na muda uliochagua — au programu haina tena jukumu la Contributor kwenye kikundi cha rasilimali. Ujumbe huu miwili inafanana, kwa hivyo kagua ukabidhi wa jukumu kabla ya kuunda siri mpya.
Hakuna kinachopatikana. Hakikisha kuwa Subscription ID na Resource group ni zile ulizokabidhi jukumu hilo, na kwamba Tenant ID ndiyo saraka ambayo programu hiyo imesajiliwa.
Inasema ufunguo umekataliwa. Karibu kila mara ni mojawapo ya mambo matatu: nafasi wazi au mstari mpya uliyonakiliwa nayo, ufunguo ambao muda wake umeisha, au ufunguo uliobatilishwa au kuzalishwa upya baada ya wewe kuunakili. Unda mpya na uubandike tena.
Inaunganisha, lakini kitu fulani kinashindwa baadaye. Ufunguo unathibitisha utambulisho lakini unakosa ruhusa ambayo kitendo hicho kinahitaji. Unda ufunguo mpya wenye ruhusa zilizoorodheshwa hapo juu, kisha katisha muunganisho wa zamani na uunganishe ufunguo mpya.
Kukatisha muunganisho
Fungua Integrations, pata akaunti hiyo na ubonyeze Disconnect. Hiyo inafuta ufunguo uliohifadhiwa mara moja. Chochote kilichokuwa kinautumia kinasimama kwenye kitendo chake kinachofuata, na skrini zilizoutegemea zitaarifu hivyo badala ya kushindwa kimya kimya.
Kukatisha muunganisho hakubadili kile ambacho tayari kilikwisha fanyika — rekodi, usambazaji au mipangilio tuliyobadilisha kwenye akaunti yako inabaki ilivyo. Ikiwa unafikiri ufunguo wenyewe unaweza kuwa umevuja, pia ubatilishe kwa mtoa huduma; kukatisha muunganisho kunaondoa nakala yetu, si yao.