Tila: suunniteltu julkaisuun 2026.2. Alla olevat tiedot perustuvat nykyiseen kehityshaaraan ja voivat vielä muuttua ennen julkaisua — käsittele kohdat, jotka on merkitty "vahvistetaan myöhemmin", alustavina.

Yleiskatsaus

Merkkijonoattribuutit voidaan salata lepotilassa ottamalla käyttöön Encrypt-asetus suoraan attribuutissa, ilman handlerin määrittämistä. Tämä on yksinkertaisempi vaihtoehto olemassa olevalle Encryption-handlerille tapauksissa, joissa halutaan vain suojata merkkijonokentän arvo eikä tarvita handlerin yksisuuntaista (hajautus) tai 3DES-/AES256-algoritmivalintaa.

• Salaus käyttää aina AES-256-algoritmia — tälle asetukselle ei ole algoritmivalintaa.
• Se käyttää samaa data encryption keytä kuin Encryption-handler (katso Handler - Encryption ja alla oleva Encryption Keys -osio avaimen vaihtamisesta).

Salauksen käyttöönotto attribuutissa

1. Avaa merkkijonoattribuutin sisältävä template templateeditorissa.
2. Avaa attribuutin Basic Properties -näkymä.
3. Valitse Encrypt.
4. Tallenna template.

[Vahvistetaan ennen julkaisua: tarkka kentän nimi/sijainti sellaisena kuin se julkaistaan, sekä kuvakaappaus Basic Properties -paneelista valintaruutuineen.]

Jos attribuutilla on jo olemassa olevia datakortin arvoja, näitä arvoja ei salata jälkikäteen — jokainen datakortti on tallennettava uudelleen, jotta sen arvo salautuu. Tämä vastaa Encryption-handlerin toimintaa.

Tuetut handlerit

Tämän asetuksen voi tällä hetkellä yhdistää seuraaviin:

• Ei handleria (oletus)
• Attribute Combiner -handler

[Vahvistetaan ennen julkaisua: onko tämä lopullinen tuettujen handlerien lista julkaisuhetkellä — Encrypt-asetuksen yhdistäminen muihin handlereihin saatetaan hylätä tai se voi olla tukematon.]

Arvon pituusraja

Koska salattu arvo tallennetaan kiinteämittaiseen tietokantasarakkeeseen, arvon pituudelle ennen salausta on yläraja:

• Selväkielinen arvo: enintään noin 287 tavua (UTF-8) [vahvistetaan ennen julkaisua: lopullinen raja].
• Jos arvo on liian pitkä, datakortin tallennus epäonnistuu validointivirheeseen sen sijaan, että arvo katkaistaisiin tai vioitettaisiin hiljaisesti.

REST-rajapinta

Salatun attribuutin arvon lukeminen ja kirjoittaminen REST-rajapinnan kautta on tuettua. Luettaessa rajapinta palauttaa puretun selväkielisen arvon — ei raakaa salattua muotoa (ciphertext) — joten rajapintaa käyttävien integraatioiden ei tarvitse itse purkaa salausta.

Vienti Classic UI:sta

Datakorttien vienti Classic UI:sta purkaa näiden salattujen arvojen salauksen viedyssä tulosteessa. Tämä eroaa olemassa olevasta Encryption-handlerista, jossa viedyt arvot pysyvät salattuina — tarkoituksellinen parannus tähän uudempaan salausvaihtoehtoon.

Tunnetut rajoitukset

• List view: ad hoc -kaavioiden luominen salatun attribuutin perusteella tai salatun attribuutin arvon käyttäminen list view -ehdossa/suodattimessa ei ole tuettua.

Encryption Keys (pääkäyttäjille)

Tämän asetuksen (ja Encryption-handlerin) käyttämä data encryption key voidaan vaihtaa kohdasta Administration > Maintenance > Encryption Keys > Generate new data encryption key. Tämä näyttää nykyisen avaimen algoritmin ja luontitiedot, ja vaatii vahvistuksen valintaikkunassa ennen vaihtoa — avaimen vaihto salaa kaikki tällä hetkellä salatut arvot uudelleen uudella avaimella, ja se keskeytetään turvallisesti (mitään muutoksia ei tehdä), jos jotain olemassa olevaa arvoa ei voida ensin purkaa tai salata uudelleen.

[Vahvistetaan ennen julkaisua: linkitä oma Encryption Keys -pääkäyttäjäartikkeli, kun se on olemassa, ja vahvista tarkka valikkopolku/nimet julkaistua käyttöliittymää vasten.]

Katso myös

• Handler - Encryption — handleriin perustuva salaus-/hajautusmekanismi (3DES/AES256/SHA-512) tapauksiin, joissa tarvitaan yksisuuntaista hajautusta tai useita algoritmivaihtoehtoja.
• Azure Key Vault Envelope Encryption for Data Encryption Keys — data encryption keyn itsensä suojaaminen asiakkaan hallinnoimalla avaimella Azure Key Vaultissa.