Telepítési útmutató

Két dolognak kell élőben lennie a webhelyén: a tájékoztató, amelyet a látogatói látnak, és egy kis méretű nyilvános fájl, amely deklarálja az MI-használatát (yoursite.com/.well-known/ai-disclosure.json). A kódrészlet-címkét egyszer illeszti be, minden oldalon azonos, és a deklarációja dönti el, hogy melyik tájékoztató hol jelenik meg. Válassza ki a platformját alább; a legtöbb körülbelül tíz percet vesz igénybe.

1 · A tájékoztatók megjelenítése

Banner és MI-címkék, amelyeket a látogatói az oldalon látnak.

2 · A deklaráció közzététele

ai-disclosure.json, egy nyilvános fájl, amely a saját domainjéről olvasható.

Akkor van kész, amikor

az ellenőrző a 2. szint · Megjelenített állapotot mutatja.

Válassza ki a platformját

WordPress

  1. A bővítmény telepítése

    A WordPress adminban: Bővítmények → Új hozzáadása → Bővítmény feltöltése, válassza ki az alább letöltött fájlt, majd kattintson az Aktiválás gombra.

    Az AIDisclose bővítmény letöltése (.zip)

  2. Végezze el mindkét feladatot

    A bővítmény megjeleníti a tájékoztatókat, és automatikusan közzéteszi a deklarációs fájlját. Bármely bejegyzést vagy képet megjelölhet MI-tartalomként az „MI-tartalom” kapcsolójával. Nincs szükség kódszerkesztésre.

  3. Ellenőrzés

    Kész, amikor az ellenőrző a 2. szint · Megjelenített állapotot mutatja.

    Ellenőrző futtatása

Ellenőrzés

Futtassa az ellenőrzőt. Három dolgot igazol: a deklarációs fájlja érvényes, a kódrészlet fut, és a tájékoztatók valóban megjelennek az oldalon. (Mérnököknek: a C1, C3 és a C4-től C6-ig terjedő ellenőrzések.)

Ellenőrző futtatása

Ha a webhelye blokkolja az ellenőrzőnket (AIDiscloseBot)

Az ellenőrzések és a bizonyítékrögzítések az AIDiscloseBot/1.0 azonosítótól érkeznek. Csak nyilvános oldalakat olvas: soha nem jelentkezik be, soha nem küld be űrlapokat, és betartja a robots.txt szabályait. Ha a robots.txt vagy egy botvédelem blokkolja az ismeretlen bejárókat, engedélyezze kifejezetten:

robots.txt
User-agent: AIDiscloseBot
Allow: /

Kockázatos az engedélyezése? Nem. A robots.txt engedélye nem ad hozzáférést. Csak azt közli az udvarias botokkal, hogy elolvashatják a már nyilvános oldalakat. Bárki hamisíthat User-Agent karakterláncot, de egy hamisító semmi olyat nem nyer, amit a nyilvános oldalai már ne adnának meg neki.

Ha WAF-fal vagy botkezelővel szűri a forgalmat, soha ne engedélyezzen kizárólag a User-Agent alapján. Párosítsa forrásellenőrzéssel. A bejáró azonosságunkat és a kimenő IP-tartományokat, ahogy azokat kiosztjuk, itt tesszük közzé: aidisclose.io/bot.json.

Ellenőrző futtatása

Speciális beállítások

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

A szkript pontos verzióhoz rögzítése (SRI)

A szkript-címkében elhelyezett integritás-hash miatt a böngésző megtagadja egy módosított fájl futtatását. Rögzítse a verziószámmal ellátott URL-t, és hozza létre a hasht pontosan abból a fájlból, amelyet telepít:

shell
curl -sO https://cdn.aidisclose.io/v1/aidisclose.js
openssl dgst -sha384 -binary aidisclose.js | openssl base64 -A
Szolgáltassa a fájlt saját maga (nginx / Apache)

Az Ön által felügyelt kiszolgálókon szolgáltassa közvetlenül a letöltött ai-disclosure.json fájlt:

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>
A vezérlőpulton tárolt fájl szolgáltatása a saját domainjéről

A kiszolgálója továbbítja hozzánk az arra az egy címre érkező kéréseket: Ön a vezérlőpulton szerkeszti a fájlt, az mégis a saját domainjéről szolgálódik ki. A vezérlőpult ezeket a webhelykulcsával előre kitöltve mutatja.

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);
  }
};
Egyoldalas alkalmazások és statikus tárhelyek

Azok a keretrendszerek, amelyek minden útvonalat az index.html fájlra írnak át, valamint egyes statikus tárhelyek elfogják a /.well-known/ai-disclosure.json kérést, és 200-as státusszal az alkalmazás HTML-jét adják vissza. Úgy tűnik, a fájl a helyén van, de az ellenőrző a manifeszt helyett a HTML-t olvassa be. Két megoldás: zárja ki a /.well-known/ útvonalat a mindent lefedő átírásból, hogy a statikus fájl application/json típussal jelenjen meg, vagy adja hozzá a data-aidisclose="YOUR_SITE_KEY" attribútumot a script címkéhez, hogy az AIDisclose által tárolt manifeszt töltődjön be, és a fájlt egyáltalán ne kelljen kiszolgálni.

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" }
] }