AIDisclose
Začať
ENFRSK

Sprievodca inštaláciou

Na vašej stránke musia byť zavedené dve veci: oznámenie, ktoré vidia vaši návštevníci, a malý verejný súbor deklarujúci vaše používanie UI (vasastranka.sk/.well-known/ai-disclosure.json). Značka skriptu sa vkladá raz, je rovnaká na každej stránke a vaša deklarácia rozhoduje, ktoré oznámenia sa kde zobrazia. Vyberte si platformu nižšie; väčšina zaberie približne desať minút.

1 · Zobrazte oznámenia

Banner a označenia UI, ktoré vaši návštevníci vidia na stránke.

2 · Zverejnite svoju deklaráciu

ai-disclosure.json, verejný súbor čitateľný z vašej vlastnej domény.

Hotovo máte, keď

kontrolný nástroj zobrazí Úroveň 2 · Zobrazené.

Vyberte si platformu

WordPress

  1. Nainštalujte plugin

    V administrácii WordPress: Pluginy → Pridať nový → Nahrať plugin, vyberte súbor, ktorý ste stiahli nižšie, a potom kliknite na Aktivovať.

    Stiahnuť plugin AIDisclose (.zip)

  2. Nechajte ho vykonať obe úlohy

    Plugin zobrazuje oznámenia a automaticky zverejňuje váš súbor s deklaráciou. Obsah vytvorený UI označte na ktoromkoľvek príspevku alebo obrázku prepínačom „AI content“. Žiadne úpravy kódu.

  3. Overenie

    Hotovo, keď kontrolný nástroj zobrazí Úroveň 2 · Zobrazené.

    Spustiť kontrolný nástroj

Overenie

Spustite kontrolný nástroj. Potvrdí tri veci: váš súbor s deklaráciou je platný, skript beží a oznámenia sa skutočne zobrazujú na stránke. (Pre technikov: kontroly C1, C3 a C4 až C6.)

Spustiť kontrolný nástroj

Ak vaša stránka blokuje náš kontrolný nástroj (AIDiscloseBot)

Kontroly a zachytenia dôkazov pochádzajú z AIDiscloseBot/1.0. Číta iba verejné stránky: nikdy sa neprihlasuje, nikdy neodosiela formuláre a rešpektuje robots.txt. Ak váš robots.txt alebo ochrana pred botmi blokuje neznáme prehľadávače, povoľte ho výslovne:

robots.txt
User-agent: AIDiscloseBot
Allow: /

Je jeho povolenie rizikom? Nie. Povolenie v robots.txt neudeľuje žiadny prístup. Iba oznamuje slušným botom, že môžu čítať stránky, ktoré sú už verejné. Reťazec User-Agent môže sfalšovať ktokoľvek, ale falšovateľ nezíska nič, čo mu vaše verejné stránky už aj tak neponúkajú.

Ak riadite prevádzku pomocou WAF alebo správcu botov, nikdy nepovoľujte len na základe User-Agent. Skombinujte to s overením zdroja. Identitu nášho prehľadávača a rozsahy odchádzajúcich IP adries, ako sú prideľované, zverejňujeme na aidisclose.io/bot.json.

Spustiť kontrolný nástroj

Rozšírené

Theming with CSS variables, custom copy, single-page-app setup, and the full option reference are in the snippet reference.

Uzamknite skript na presnú verziu (SRI)

Integritný haš v značke script spôsobí, že prehliadač odmietne spustiť upravený súbor. Pripnite verzovanú URL a vygenerujte haš z presného súboru, ktorý nasadzujete:

shell
curl -sO https://cdn.aidisclose.io/v1/aidisclose.js
openssl dgst -sha384 -binary aidisclose.js | openssl base64 -A
Poskytujte súbor sami (nginx / Apache)

Na serveroch, ktoré ovládate, poskytujte stiahnutý ai-disclosure.json priamo:

nginx
location = /.well-known/ai-disclosure.json {
  alias /var/www/site/ai-disclosure.json;
  default_type application/json;
  add_header Cache-Control "max-age=3600";
}
Apache
Alias "/.well-known/ai-disclosure.json" "/var/www/site/ai-disclosure.json"
<Files "ai-disclosure.json">
  ForceType application/json
</Files>
Poskytujte súbor hostovaný v dashboarde z vlastnej domény

Váš server nám preposiela požiadavky na túto jednu adresu: súbor upravujete v dashboarde a naďalej sa poskytuje z vašej domény. Dashboard ich zobrazuje predvyplnené vaším kľúčom stránky.

nginx
location = /.well-known/ai-disclosure.json {
  proxy_pass https://cdn.aidisclose.io/v1/hosted-manifest/YOUR_SITE_KEY;
  proxy_set_header Host cdn.aidisclose.io;
  proxy_ssl_server_name on;
}
Cloudflare Worker
export default {
  async fetch(request) {
    const url = new URL(request.url);
    if (url.pathname === "/.well-known/ai-disclosure.json") {
      return fetch("https://cdn.aidisclose.io/v1/hosted-manifest/YOUR_SITE_KEY");
    }
    return fetch(request);
  }
};
Jednostránkové aplikácie a statické hostingy

Frameworky, ktoré prepisujú každú routu na index.html, a niektoré statické hostingy zachytávajú /.well-known/ai-disclosure.json a vracajú HTML vašej aplikácie so stavom 200. Súbor vyzerá ako commitnutý, ale kontrolný nástroj číta HTML namiesto manifestu. Dve riešenia: vyňte /.well-known/ z pravidla prepisujúceho všetky routy, aby sa statický súbor doručoval s typom application/json, alebo pridajte data-aidisclose="YOUR_SITE_KEY" k tagu skriptu, aby sa načítal manifest hostovaný na AIDisclose a súbor sa nemusel doručovať vôbec.

netlify.toml / vercel.json
# netlify.toml: serve the real file before the SPA fallback
[[redirects]]
  from = "/*"
  to = "/index.html"
  status = 200
  force = false   # a real file at the path wins over this fallback

# vercel.json: rewrite everything EXCEPT /.well-known to the app
{ "rewrites": [
  { "source": "/((?!\.well-known/).*)", "destination": "/index.html" }
] }