Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Cosain do Chlár Eochrach API: Ná Nocht É ar an Taobh Cliant Riamh

Ceacht 6 as 12 Nuashonraithe 28 Iúil 2026 Ardleibhéal
Ar an leathanach seo
  1. Is Focal Faire é Clár Eochrach API
  2. Veicteoirí Coitianta Nochta
  3. Ailtireacht Seachfhreastalaí: An Réiteach
  4. Stóráil Shlán Eochracha
  5. Cad le Déanamh má Chuirtear d’Eochair i mBaol
  6. Príomhphointí

Is Focal Faire é Clár Eochrach API

Feidhmíonn do chlár eochrach xAI API cosúil le focal faire a thugann rochtain iomlán ar do chuntas. Is féidir le duine ar bith a bhfuil sé aige glaonna API a dhéanamh ar do chostas, rochtain a fháil ar do mhúnlaí, agus do chuid sonraí a chur i mbaol, b’fhéidir. Conas a bhíonn sé difriúil ó ghnáthfhocal faire? Is féidir eochair ghoidte a úsáid go ciúin: ní fheicfidh tú rud ar bith go dtí go dtagann an bille, nó go dtí go gcuireann d’fhoireann airgeadais foláireamh amach. Is simplí agus absalóideach an riail: ná nocht clár eochrach API ar an taobh cliant riamh.

Veicteoirí Coitianta Nochta

Is é an cás is coitianta ná an eochair a chur go díreach i JavaScript an fhronta:

// DANGER - NEVER do this
const response = await fetch("https://api.x.ai/v1/chat/completions", {
  headers: { "Authorization": "Bearer xai-abc123..." }
});

Nuair a imrítear an cód seo, tá sé le feiceáil ag duine ar bith a úsáideann uirlisí forbróra an bhrabhsálaí. Níl le déanamh agat ach an cluaisín Líonra a oscailt chun an eochair a léamh i ngnáth-théacs i gceanntásc an iarratais.

Veicteoir níos insidious é athróga timpeallachta an fhronta, toisc go dtugann siad bréag-bhraistint slándála. Déantar athróga a bhfuil an réimír NEXT_PUBLIC_, VITE_, nó REACT_APP_ orthu a bhunú sa JavaScript ag am na tógála, agus mar sin tá siad poiblí. Ceapann an forbróir go bhfuil an eochair “coinnithe amach as an gcód”; i ndáiríre, níl ann ach go bhfuil sé tiomsaithe isteach ann:

# DANGER - this variable will be in the bundle
NEXT_PUBLIC_XAI_API_KEY=xai-abc123...

Is iad stórais Git an tríú veicteoir clasaiceach. Fiú gealltanas scriosta, fanann sé i stair Git: má rinne tú eochair a ghealladh de thaisme, ní leor an stair a athscríobh, toisc go bhféadfadh clóin agus forcanna tarraingt anuas air fós. Meas go bhfuil sé curtha i mbaol agus tarraing siar é. Ar deireadh, sileann eochracha amach freisin trí chonairí indíreacha, rud atá níos deacra a shamhlú ach an-choitiant: logaí feidhmchláir a rianaíonn ceanntásc iomlána, teachtaireachtaí earráide a thaispeántar don úsáideoir, nó uirlisí monatóireachta a ghabhann iarratais amach.

Ailtireacht Seachfhreastalaí: An Réiteach

Níl ach cur chuige amháin atá slán: gach glao a sheachadadh trí do chúlchóras:

Client (browser/mobile)
    ↓ request without API key
Your Backend (server)
    ↓ adds API key (environment variable)
xAI API
    ↓ response
Your Backend
    ↓ forwards response (filtered if needed)
Client

Seo seachfhreastalaí íosta i bPython:

# Python Backend (Flask)
import os
from flask import Flask, request, jsonify
import requests

app = Flask(__name__)
XAI_KEY = os.environ["XAI_API_KEY"]  # Server-side variable only

@app.route("/api/chat", methods=["POST"])
def proxy_chat():
    user_message = request.json.get("message")

    response = requests.post(
        "https://api.x.ai/v1/chat/completions",
        headers={"Authorization": f"Bearer {XAI_KEY}"},
        json={
            "model": "grok-4.3",
            "messages": [{"role": "user", "content": user_message}]
        }
    )

    return jsonify(response.json())

Seachas an eochair a chosaint—nach dtarchuirtear chuig an gcliant riamh—tugann an seachfhreastalaí pointe rialaithe duit nach bhfuil indéanta le glaonna díreacha. Is féidir leat iarratais a scagadh: teorannú ráta chun cosc a chur ar chliaint do chuóta a dhraenáil, bailíochtú ionchuir, measúnú ábhair. Is tú a rialaíonn cé na múnlaí atá inrochtana, rud a choscann ar chliaint fhuadaithe múnla costasach a ghlaoch agus costais gan choinne a ghiniúint. Is féidir leat glaonna a logáil chun críche iniúchta—riachtanas lárnach do cheannaire comhlíontachta. Agus is féidir leat freagairtí áirithe a chur i dtaisce chun costais a laghdú ar iarratais athfhillteacha.

Stóráil Shlán Eochracha

Ar an taobh freastalaí, is é an bonnlíne ná an athróg timpeallachta, a lódáiltear ó chomhad .env nach ndéantar riamh a ghealladh do Git:

# .env file (NEVER committed to Git)
XAI_API_KEY=xai-your-secret-key

Cuir na comhaid seo go córasach le do .gitignore:

# .gitignore
.env
.env.local
.env.production

I dtimpeallachtaí táirgeachta, fanann comhad .env a chuirtear ar fhreastalaí mar phróiseas láimhe leochaileach: is fearr bainisteoir rúnda tiomnaithe a úsáid. I measc na roghanna cruthaithe tá AWS Secrets Manager nó SSM Parameter Store, Google Secret Manager, Azure Key Vault, HashiCorp Vault, nó Doppler agus Infisical do struchtúir níos éadroime. Cad a sholáthraíonn na huirlisí seo thar chomhad cothrom: rothlú uathoibríoch eochracha, iniúchadh rochtana—cé a léigh cén rún, cathain—agus criptiú ar fos. Is iad seo na gnéithe is féidir leat a chur i láthair mar atá siad le linn iniúchta slándála, agus ní chruthaíonn comhad téacs ar mheaisín aon rud.

Cad le Déanamh má Chuirtear d’Eochair i mBaol

Má amhras tú go bhfuil eochair nochtaithe, tá an t-ord oibríochta chomh tábhachtach leis na hoibríochtaí féin. Tarraing siar an eochair sa chonsól xAI (console.x.ai) sula ndéanann tú aon rud eile: gach nóiméad a fhanann an eochair chompromáideach gníomhach, is nóiméad é d’fhorghabháil fhéideartha, agus déileáiltear le leanúnachas seirbhíse ina dhiaidh sin, ní roimhe. Ansin, gineann tú eochair nua agus nuashonraíonn tú do chúlchórais chun an tseirbhís a athbhunú.

Níl an teagmhas críochnaithe fós. Déan iniúchadh ar an úsáid trí ghlaonna API amhrasacha a lorg i do stair bhilleála—buaic le linn fuinneoige ama neamhghnáthaí, úsáid a thugtar le múnla nach n-úsáideann tú. Sainaithin foincs an tsileadh, murach sin, leanfaidh an eochair nua an conair chéanna leis an sean-eochair. Críochnaigh trí do chód a scanadh le huirlisí cosúil le gitleaks nó truffleHog, a thrasnaíonn stair Git freisin agus a nochtann go minic rúin eile a rinneadh dearmad orthu le fada.

Príomhphointí

  • Is focal faire é clár eochrach API a thugann rochtain iomlán ar do chuntas
  • Seachadaigh glaonna API i gcónaí trí do chúlchóras
  • Tá athróga NEXT_PUBLIC_, VITE_, REACT_APP_ poiblí
  • Úsáid bainisteoir rúnda i dtáirgeadh
  • Má chuirtear eochair i mbaol, tarraing siar láithreach é agus déan iniúchadh ar an úsáid