Asennusopas

Kaksi asiaa on saatava sivustollasi näkyviin: kävijöidesi näkemä ilmoitus ja pieni julkinen tiedosto, joka ilmoittaa tekoälyn käytöstäsi (yoursite.com/.well-known/ai-disclosure.json). Koodinpätkän tunniste liitetään kerran, se on identtinen jokaisella sivulla, ja ilmoituksesi ratkaisee, mitkä ilmoitukset näkyvät missäkin. Valitse alustasi alta; useimmilla se vie noin kymmenen minuuttia.

1 · Näytä ilmoitukset

Banneri ja tekoälymerkinnät, jotka kävijäsi näkevät sivulla.

2 · Julkaise ilmoituksesi

ai-disclosure.json, julkinen tiedosto, joka on luettavissa omalta verkkotunnukseltasi.

Olet valmis, kun

tarkistustyökalu näyttää tuloksen Taso 2 · Näytetty.

Valitse alustasi

WordPress

  1. Asenna lisäosa

    WordPress-hallinnassasi: Lisäosat → Lisää uusi → Lähetä lisäosa, valitse alta lataamasi tiedosto ja napsauta sitten Ota käyttöön.

    Lataa AIDisclose-lisäosa (.zip)

  2. Anna sen hoitaa molemmat tehtävät

    Lisäosa näyttää ilmoitukset ja julkaisee ilmoitustiedostosi automaattisesti. Merkitse tekoälysisältö mihin tahansa julkaisuun tai kuvaan sen "AI content" -kytkimellä. Ei koodimuokkauksia.

  3. Varmista

    Valmis, kun tarkistustyökalu näyttää tuloksen Taso 2 · Näytetty.

    Suorita tarkistus

Varmista

Suorita tarkistus. Se vahvistaa kolme asiaa: ilmoitustiedostosi on kelvollinen, koodinpätkä on käynnissä ja ilmoitukset todella näkyvät sivulla. (Insinööreille: tarkistukset C1, C3 ja C4–C6.)

Suorita tarkistus

Jos sivustosi estää tarkistustyökalumme (AIDiscloseBot)

Tarkistukset ja todistetallenteet tulevat AIDiscloseBot/1.0:sta. Se lukee vain julkisia sivuja: se ei koskaan kirjaudu sisään, ei koskaan lähetä lomakkeita ja noudattaa robots.txt-tiedostoa. Jos robots.txt-tiedostosi tai bottisuojauksesi estää tuntemattomat indeksoijat, salli se nimenomaisesti:

robots.txt
User-agent: AIDiscloseBot
Allow: /

Onko sen salliminen riski? Ei. Robots.txt-salliminen ei anna mitään käyttöoikeuksia. Se vain kertoo kohteliaille boteille, että ne saavat lukea jo julkisia sivuja. Kuka tahansa voi väärentää User-Agent-merkkijonon, mutta väärentäjä ei saa mitään sellaista, mitä julkiset sivusi eivät jo anna.

Jos suodatat liikennettä WAF:lla tai bottihallinnalla, älä koskaan salli pelkän User-Agentin perusteella. Yhdistä se lähteen vahvistukseen. Julkaisemme indeksoijamme identiteetin ja lähtevän liikenteen IP-alueet sitä mukaa kuin niitä otetaan käyttöön osoitteessa aidisclose.io/bot.json.

Suorita tarkistus

Lisäasetukset

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

Lukitse skripti tarkkaan versioon (SRI)

Skriptitunnisteessa oleva eheystiiviste saa selaimen kieltäytymään muokatun tiedoston suorittamisesta. Kiinnitä versioitu URL-osoite ja luo tiiviste täsmälleen siitä tiedostosta, jonka otat käyttöön:

shell
curl -sO https://cdn.aidisclose.io/v1/aidisclose.js
openssl dgst -sha384 -binary aidisclose.js | openssl base64 -A
Tarjoa tiedosto itse (nginx / Apache)

Hallitsemillasi palvelimilla tarjoa ladattu ai-disclosure.json suoraan:

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>
Tarjoa hallintapaneelissa isännöity tiedosto omalta verkkotunnukseltasi

Palvelimesi välittää tuon yhden osoitteen pyynnöt meille: muokkaat tiedostoa hallintapaneelissa, ja se tarjotaan silti verkkotunnukseltasi. Hallintapaneeli näyttää nämä valmiiksi täytettyinä sivustoavaimellasi.

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);
  }
};
Yhden sivun sovellukset ja staattiset isännät

Kehykset, jotka kirjoittavat jokaisen reitin uudelleen osoitteeseen index.html, ja jotkin staattiset isännät sieppaavat osoitteen /.well-known/ai-disclosure.json ja palauttavat sovelluksesi HTML:n 200-tilakoodilla. Tiedosto näyttää olevan versionhallinnassa, mutta tarkistustyökalu lukee HTML:ää manifestin sijaan. Kaksi korjausta: jätä /.well-known/ pois kaiken kattavasta uudelleenkirjoituksesta, jotta staattinen tiedosto tarjotaan application/json-tyypillä, tai lisää data-aidisclose="YOUR_SITE_KEY" skriptitunnisteeseen, jotta AIDisclosen isännöimä manifesti ladataan eikä tiedostoa tarvitse tarjota lainkaan.

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