Jinsi ya Kuongeza Kuingia kwenye Programu Yako: Nywila, Viungo vya Kuingia, Google na Majukumu

Ili kuongeza kuingia kwenye programu, chagua njia — barua pepe na nywila, viungo vya kuingia (kiungo cha mara moja cha kuingia kinachotumwa kwa barua pepe), au "Sign in with Google" — kisha uitekeleze kwa maktaba ya uthibitishaji iliyothibitishwa au mtoa huduma anayehudumiwa badala ya kuanza kutoka mwanzo. Kisha amua kila aina ya mtumiaji anaruhusiwa kufanya nini (majukumu), na uitekeleze hiyo kwenye seva kwa kila ukurasa na kila ombi la API. Vikao vinapaswa kutumia vidakuzi salama, viishe muda, na kumalizika ipasavyo wakati wa kutoka.

Mwongozo huu unapitia kila chaguo na maelezo yanayotenganisha kuingia kunakofanya kazi na kuingia salama. Kwa dhana zinazokiunga, tazama uthibitishaji ni nini.

Amua kwanza: je, unahitaji kuingia kabisa?

Kuingia kunaongeza msuguano na uwajibikaji. Unakihitaji pale:

• Watumiaji wana data binafsi (miadi yao, nyaraka zao, ankara zao)
• Watumiaji wanaweza kubadilisha vitu ambavyo wengine wataviona
• Unatoza ada kwa ufikiaji
• Watu tofauti wanahitaji ruhusa tofauti (mmiliki dhidi ya mfanyakazi dhidi ya mteja)

Huenda usiukihitaji kwa tovuti ya masoko, saraka ya umma, au fomu inayokutumia barua pepe tu. Orodha ya kusubiri haihitaji akaunti; sehemu ya barua pepe inatosha.

Njia nne za kawaida za kuingia

Programu nyingi huchanganya mbili: Google sign-in pamoja na viungo vya kuingia kwa barua pepe ni mchanganyiko maarufu unaowafikia watu wengi bila kuhifadhi nywila yoyote.

Barua pepe na nywila

Ikiwa unatoa nywila, haya ni ya lazima:

• Hash nywila kwa algoriti ya polepole ya kuhash nywila. Mwongozo wa OWASP wa kuhifadhi nywila unapendekeza Argon2id, na scrypt, bcrypt au PBKDF2 kama mbadala. Usihifadhi nywila kama maandishi wazi wala kwa hash ya haraka ya kawaida.
• Kuweka upya nywila kunatumia kiungo cha nasibu, cha matumizi moja, kinachoisha muda, kinachotumwa kwa barua pepe iliyothibitishwa.
• Usifichue ni barua pepe zipi zina akaunti. "Ikiwa barua pepe hiyo imesajiliwa, tumetuma kiungo cha kuweka upya" ni bora kuliko "Hakuna akaunti iliyopatikana".
• Weka kikomo cha majaribio ya kuingia na kuweka upya ili kupunguza kasi ya kukisia nywila.
• Ruhusu nywila ndefu na wasimamizi wa nywila; ruka kanuni zinazolazimisha mchanganyiko wa herufi zisizo za kawaida.

Viungo vya kuingia na misimbo ya mara moja

Kiungo cha kuingia ni kiungo cha kuingia kinachotumwa kwa mtumiaji kwa barua pepe. Kukibofya kunamwingiza. Msimbo wa mara moja ni wazo lilelile, lakini unaandikwa badala ya kubofya.

• Viungo na misimbo huisha haraka na hufanya kazi mara moja tu.
• Kiungo kinapaswa kumwingiza mtumiaji kwenye kifaa alichobofya, na tokeni lisibaki kwenye kumbukumbu au zana za analitiki.
• Unahitaji utumaji wa barua pepe unaoaminika — tazama jinsi ya kutuma barua pepe kutoka kwenye programu yako. Jaribu kwa Gmail na Outlook, na angalia folda za barua taka.

Sign in with Google (na watoa huduma wengine wa OAuth)

"Sign in with Google" hutumia OAuth na OpenID Connect: Google inathibitisha mtumiaji ni nani na inamwambia programu yako barua pepe na jina lake. Usanidi, kufikia Septemba 2026, unafanyika kwenye sehemu ya Google Auth Platform ya Google Cloud Console:

1. Unda au chagua mradi, kisha jaza ukurasa wa Branding — kile watumiaji wanachokiona kwenye skrini ya idhini (jina la programu, barua pepe ya usaidizi, nembo).
2. Kwenye ukurasa wa Clients, unda mteja wa aina "Web application".
3. Ongeza authorized JavaScript origins na redirect URIs — anwani kamili ambazo programu yako inaendeshwa na ambazo Google inarudisha watumiaji nazo baada ya kuingia.
4. Hifadhi client ID na client secret kwenye siri za programu yako.

Mambo yanayoharibika mara kwa mara, kulingana na nyaraka za OAuth za Google:

• redirect_uri_mismatch: anwani ya redirect lazima ilingane kabisa, ikiwemo http dhidi ya https, herufi kubwa na kistari cha mwisho. Ongeza moja kwa anwani yako ya onyesho la awali na nyingine kwa kikoa chako cha moja kwa moja.
• HTTPS inahitajika: URI za redirect lazima zitumie HTTPS, isipokuwa localhost wakati wa maendeleo.
• Parameta ya state inapaswa kukaguliwa wakati wa kurudi, ili kulinda dhidi ya ombi bandia la kuvuka tovuti (CSRF). Maktaba nzuri hufanya hili kwa ajili yako.

Ikiwa unaomba taarifa za msingi za kuingia pekee (jina, barua pepe, wasifu), Google inasema uthibitishaji wa programu si wa lazima. Kuomba ufikiaji wa Gmail, Drive au Kalenda za watumiaji ni tofauti na kunahitaji uthibitishaji.

Jenga mwenyewe au tumia mtoa huduma?

Zote mbili za kwanza ni za busara. Watoa huduma wanaohudumiwa wanashughulikia zaidi kwa ajili yako lakini wanaongeza utegemezi na wakati mwingine gharama kwa kila mtumiaji anayefanya kazi; angalia bei za sasa kwenye tovuti zao. Maktaba zinaweka kila kitu kwenye hifadhidata yako lakini zinakuachia zaidi cha kusanidi kwa usahihi. Chochote utakachochagua, muombe AI itumie hicho badala ya kuandika mantiki ya nywila au kikao kwa mkono.

Majukumu na ruhusa

Kuingia kunakuambia nani mtu ni. Ruhusa zinaamua anaweza kufanya nini. Weka rahisi mwanzoni:

Kanuni zinazojali zaidi kuliko majina ya majukumu:

• Kagua kwenye seva, kila wakati. Kuficha kitufe kwenye ukurasa hakuzuii mtu kuita API moja kwa moja.
• Weka wigo kwa mmiliki. Mwanachama anayeomba "booking 123" apate tu kama ni yake.
• Watumiaji hawawezi kujipandisha vyeo. Puuza sehemu za jukumu zinazotumwa kutoka kivinjari wakati wa masasisho ya wasifu.
• Chaguo-msingi ni hakuna ufikiaji. Njia mpya zihitaji kuingia isipokuwa umeamua vinginevyo.

Jaribu kwa akaunti mbili: ingia kama moja, kumbuka ID ya rekodi, kisha ingia kama nyingine ujaribu kuifungua. Orodha yetu ya usalama ina jaribio kamili.

Usalama wa kikao

Baada ya kuingia, programu inamkumbuka mtumiaji kwa kikao — kwa kawaida kidakuzi. Mwongozo wa OWASP wa usimamizi wa vikao unapendekeza:

• Vidakuzi vya kikao vimewekwa na Secure (HTTPS pekee), HttpOnly (haviwezi kusomwa na hati za ukurasa) na SameSite
• Kitambulisho kipya cha kikao kinatolewa wakati wa kuingia, na tena mamlaka yanapobadilika
• Muda wa kutofanya kazi na muda wa juu kabisa wa maisha, vinavyotekelezwa kwenye seva
• Kutoka kunamaliza kikao kwenye seva, si kufuta kidakuzi tu
• Vikao vinabatilishwa mtumiaji anapobadilisha nywila yake

Kuhifadhi tokeni za kuingia kwenye local storage ya kivinjari ni kawaida kwenye mafunzo, lakini inaziweka wazi kwa hati yoyote inayoendeshwa kwenye ukurasa; vidakuzi salama kwa kawaida ni chaguo bora kwa programu za wavuti.

Ombi linaloshughulikia msingi

Ongeza akaunti za watumiaji kwenye programu hii. Watumiaji wanaweza kujisajili na kuingia kwa barua pepe na nywila, au kwa Google. Tumia [maktaba au mtoa huduma] badala ya msimbo wa uthibitishaji wa kujitengenezea. Hash nywila kwa Argon2id au bcrypt. Ongeza kuweka upya nywila kwa barua pepe, kwa kiungo cha matumizi moja kinachoisha baada ya saa moja. Weka vikao kwenye vidakuzi salama vya HttpOnly. Linda /dashboard na kila njia ya /api ili watumiaji walioingia pekee waitumie, na hakikisha watumiaji wanaona miradi yao wenyewe pekee. Ongeza jukumu la "admin" linaloweza kuona watumiaji wote; ni wasimamizi pekee wanaoweza kufikia /admin, wakikaguliwa kwenye seva.

Kisha jaribu: jisajili, toka, ingia, weka upya nywila, jaribu URL ya faragha ukiwa umetoka, na jaribu rekodi ya mtumiaji mwingine.

Makosa ya kawaida katika kuingia kwa AI

• Ulinzi kwenye ukurasa tu. Ukurasa unaelekeza watumiaji waliotoka, lakini API inarudisha data kwa yeyote.
• Siri kwenye kivinjari. Siri za mteja wa OAuth na funguo za msimamizi wa mtoa huduma wa uthibitishaji zinakaa kwenye seva.
• URL ya onyesho la awali na ya moja kwa moja zimechanganyika. Redirect URI ya Google au kiungo cha barua ya kuweka upya kinaelekeza kwenye onyesho la awali, kwa hiyo kuingia kunavunjika baada ya kuchapisha.
• Hakuna uthibitishaji wa barua pepe. Mtu yeyote anaweza kujisajili kama anyone@company.com. Thibitisha barua pepe kabla ya kutoa chochote kinachofungamana na anwani hiyo.
• Kujaribu njia nzuri pekee. Jaribu nywila mbaya, viungo vilivyoisha muda na akaunti ya pili.

Kuongeza kuingia katika Mythex

Kwenye Mythex, kuingia kwa watumiaji wa programu yako ni kitu unachokiongeza kwenye programu yako — kinatenganishwa na akaunti yako ya Mythex. Mythex haitoi bidhaa ya uthibitishaji iliyojengwa ndani, kwa hiyo unaleta maktaba au mtoa huduma wa uthibitishaji pamoja na funguo zake:

1. Chagua mbinu — kwa mfano barua pepe na nywila zilizohifadhiwa kwenye hifadhidata yako, au SDK ya mtoa huduma anayehudumiwa.
2. Ukihifadhi watumiaji mwenyewe, programu inahitaji hifadhidata; iombe kwenye mazungumzo au tumia /database.
3. Weka funguo za mtoa huduma kwenye siri za mradi (/secrets au mipangilio ya mradi).
4. Tumia ombi kama lile hapo juu, kisha jaribu kwenye Preview. Kwa Google sign-in, ongeza redirect URI za onyesho lako la awali na za anwani yako iliyochapishwa.

Tazama Ongeza kuingia kwenye programu yako katika nyaraka. Ikiwa unajenga bidhaa ya kulipia, jinsi ya kujenga MVP ya SaaS inaeleza akaunti na malipo pamoja.

Maswali