# Te Rokiroki i ngā Mea Ngaro mō tētahi Pae Tukutuku

Source: https://support.kapsulehost.com/mi-nz/site-secrets

Ko te ripa Secrets he pātaka whakamunatia mō ngā uara whirihoranga tapu e hiahiatia ana e tētahi taupānga Node.js, pērā i ngā kī API, ngā mea waitohu me ngā kaitautoko tōrau takirua, e pupurihia ana mō ia taiao, kia kaua ai ō kori whakaū me ō kori arokite e pokanoa.

## Kei Hea Ngā Secrets e Noho Ana

Whakatuwheratia **Ngā Paetukutuku**, pāwhiritia te pae, whakatuwheratia te rōpū **Environment** i te tahua mauī o te pae, kātahi ka kōwhiri i **Ngā Huna**. Ko te ingoa o te ripa ko **Ngā Huna**.

Ka puta noa te ripa i runga i ngā pae Node.js. Kāore e whakaaturia e WordPress, PHP me ngā pae pūmau, nā te mea kei ngā kōnae i runga i te kōpae ō rātou whirihoranga: `wp-config.php` mō WordPress, me ahakoa he aha tā tō anga e pānui ai mō tētahi taupānga PHP noa.

![Ripa Secrets mō tētahi pae Node.js i roto i KPanel](https://support.kapsulehost.com/help/screenshots/site-secrets.812e0706.webp)

## Me Pēhea te Tiaki i Ngā Uara

Ka whakamunatia ia uara i mua i tōna pā atu ki te pātengi raraunga. Kāore he mea e rokohanga ake hei kupu pānui, ā, kāore te tirohanga rārangi e whakaatu i tētahi uara whānui: ka whakaatu i tētahi pūare ko ngā kai whā whakamutunga anake e kitea ana, nā reira ka taea e koe te wehewehe i ngā kī rite tonu te āhua, me te kore e whakakite i tētahi o aua uara.

Kei ia rārangi tētahi tohu **Encrypted** hei whakamaumahara mō tērā. Ko te pānui anō i tētahi uara he mahi motuhake, he mahi i whakaaro iho, ehara i te mea ka puta noa i te whakatuwheratanga o te whārangi.

> **Note:** Ko te whakarite, te whakaatu me te muku i tētahi secret, me whai whakaaetanga **sites:write** katoa. Ka taea e tētahi mema tīma pānui anake te kite i ngā kī e noho ana me ō rātou pūare, engari kāore e taea te kite i ō rātou uara.

## Ngā Taiao e Rua

Kei runga ake o te whārangi tētahi mana wehe e huri ai i waenga i **production** me **preview**. He huinga kī tino motuhake tonu ēnei. Ko te whakarite i `STRIPE_SECRET_KEY` i roto i production kāore e hanga ana i a ia i roto i preview, ā, ko tōna muku mai i te preview kāore e pā ana ki te production.

Koinā te take o tēnei āhuatanga, ko taua wehenga. He taiao whakapae noa ngā hanganga preview ka taea e tētahi tangata whai urunga pātengi te whakaoho, nā reira me mau i ngā whakaū whakamātautau, ehara i te mea ora. Tirohia [Ngā Horahanga Arokite mō ngā Pull Request](https://support.kapsulehost.com/mi-nz/site-preview) mō te āhua o te hanga i ngā taiao arokite.

## Te Tāpiri, Te Whakahou Rānei i Tētahi Secret

1. Kōwhiria te taiao mā te mana wehe.
2. Tāuru i te ingoa ki te āpure **KEY_NAME**. Ka whakamanaia e te āpure ngā reta nui i a koe e tā ana.
3. Whakaurua te uara ki te āpure tuarua. Ka huna i a koe e tā ana.
4. Pāwhiritia **Set**.

Ki te whakaritea tētahi kī kua noho kē, ka tāwhiuwhiua. Kāore he mahi whakatikatika motuhake, kāore hoki he taunga whakaū mō te tāwhiuwhiu, nā reira me tirotiro koe i te ripa taiao i mua i tō pāwhiri i **Set**.

### Ngā Ture Mō Ngā Ingoa Kī

Me tīmata te kī ki tētahi reta nui, ā, ka taea te whai i ngā reta nui, ngā nama me ngā kupu piki, tae atu ki te 128 pū. He āhuatanga tika ēnei `DATABASE_URL`, `API_KEY_V2` me `SENTRY_DSN`. Ka whakakāhoretia tētahi atu mea me te karere **Me noho te kī UPPER_SNAKE_CASE reta/tau/kupu piki tīkina**.

He mea pai kia mōhio ki ētahi atu herenga e rua:

- Kāore e taea te uara te noho pātea. Mēnā ka tukuna he uara pūare, ka whakahokia te karere **me noho te uara**.
- Kāore e taea te uara e neke ake i te 16 KB. He rahi tērā mō tētahi tūtohu, engari kāore e nui mō, hei tauira, tētahi mekameka tiwhikete katoa, he mea tika kē kia noho ki tētahi kōnae, kaua ki tētahi secret.

## Te Pānui Anō i Tētahi Uara

Pāwhiritia **Copy** i runga i te rārangi. Ka wetemunatia e KPanel te uara i te taha tūmau, ka tuku tonu ki tō papatohu, me te whakaūnga **Kua kōphi te uara ki te papatohu**. Kāore te uara e whakaaturia ki te mata, nā reira kāore e kitea e tētahi tiritiri mata, e tētahi kaitiro pakihiwi rānei.

Ka tuhia ia whakaaturanga ki te rēkōta auara mahi o te pae, tae atu ki te kaimahi me te kī i whakamahia, ā, ka kitea i te [Rēkōta Mahi Pae](https://support.kapsulehost.com/mi-nz/site-activity-log).

> **Tip:** Mēnā me whakaū koe he tika tētahi uara me te kore e whakaatu, whakatairitea te pūare ake. Ko ngā kai whā whakamutunga he nui noa hei whakaū kei a koe te tūtohu tika, ā, kei te mata kē rātou.

## Te Whakamahi i Tētahi Secret I Roto I Tō Taupānga

Kōphitia te uara ki te wāhi e pānui ai tō taupānga i tōna whirihoranga i runga i te tūmau. Mō tētahi taupānga Node.js, ko tērā te nuinga he taurangi taiao i whakaritea e tō kaiwhakahaere tukanga, he kōnae `.env` rānei kei roto i te pūtake taupānga e uta ai tō waehere i te tīmatanga.

> **Warning:** Kaua tērā kōnae e tukuna ki tō pātengi. Tāpirihia `.env` ki `.gitignore` i mua i tō hanga i a ia. Mēnā kua tukuna tētahi secret ki tētahi git remote, me mahi atu me te whakaaro kua tāhaetia, ā, me huri anō i te kaiwhakarato, nā te mea ka noho tonu i roto i te hītori ahakoa kua mukua te kōnae.

Ko te ripa Secrets tō rēkōta mō te uara, e mau whakamunatia ana me te arokite, kaua he tuhinga i roto i tētahi kaiwhakahaere kupuhipa, i tētahi papa karere rānei. Kia mau tonu hei pūtake pono: ina huri koe i tētahi kī i te kaiwhakarato, whakahoutia hoki i konei i taua wā tonu, kia whai i te uara hōu te tangata e horahia ai i muri mai.

## Te Muku i Tētahi Secret

Pāwhiritia **Delete** i runga i te rārangi. Ka tono a KPanel kia whakaūngia e koe mā **Delete API_TOKEN?**, me te whakatūpato ka ngaro te taupānga i te urunga ki tēnei uara i tōna tīmatanga anō e whai ake nei. Kāore he take whakahoki, kāore hoki he kape e puritia ana, nā reira mēnā kei te whakaaro koe ka hiahiatia anōtia te uara, kōphitia i mua.

Mukua tētahi secret ina kua whakakorea te kaupapa whakamuna i te kaiwhakarato, ina rānei kua tangohia te waehere i whakamahia ai. Ko te waiho noa i ngā kī tawhito ka uaua ake, i muri mai, te mōhio ko ēhea kī e tino hira ana.

## Te Huri Haumaru i Tētahi Whakamuna

Ko te raupapa haumaru, ko tēnei tonu: hangaia te whakamuna hōu i te kaiwhakarato, whakahoutia i konei, horahia, whakaūngia e mahi ana te taupānga, kātahi ka whakakorehia te whakamuna tawhito i te kaiwhakarato.

Mēnā ka mahia whakamuri, arā, ka whakakorehia i mua, ka whai wā koe e mau ana te taupānga e rere ana ki tētahi whakamuna kua mate, ā, ka rahua ngā tono katoa e hiahia ana ki tērā. Mēnā he mōrea te huringa, tangohia tuatahitia he tāpiritanga kia hoki ai koe ki tētahi tūnga mōhiotia he pai: tirohia [Te Tango Tāpiritanga](https://support.kapsulehost.com/mi-nz/taking-a-backup).

## Te Whakaoti Raru

**Kāore te ripa Secrets i te tahua.** Ehara te pae i te pae Node.js. Tirohia te pūare rārangi e tū tata ana ki te ingoa pae i runga ake o te whārangi.

**Kāore he aha e tupu ana ina pāwhiri i te pātene Set.** E hiahiatia ana ngā āpure e rua. Ka whakapuaki te pātene i **Kī + uara e hiahia ana** mēnā kei te pātea tētahi o ngā āpure.

**I whakakāhoretia te kī.** Kāore e whakaaetia ngā reta iti, ngā tohu rārangi, ngā tohu pae me ngā mokowā. Ka rahua `api-key` me `Api_Key`; ka paea `API_KEY`.

**Kāore i uta tētahi aha ki te papatohu i te Copy.** Ka ārai ētahi pūtirotiro i ngā tuhinga papatohu i tētahi ripa korekore mahi. Pāwhiritia te whārangi i mua, kātahi ka pāwhiri anō i **Copy**.

## Ko Hea Te Haere Ki Muri Mai

- [Ngā Horahanga Arokite mō ngā Pull Request](https://support.kapsulehost.com/mi-nz/site-preview), tērā tētahi atu wāhanga o te wehenga production me preview.
- [Horahanga Git mō Tētahi Pae](https://support.kapsulehost.com/mi-nz/site-git-deploy) mō te tuku i te waehere e pānui ai i ēnei uara.
- [Rēkōta Mahi Pae](https://support.kapsulehost.com/mi-nz/site-activity-log) hei kite i te tangata nāna i whakarite, i whakaatu, i muku rānei i tētahi secret.
