Application Configuration Access Protocol

Application Configuration Access Protocol ( ACAP) je síťový protokol, který umožňuje uživateli přístup ke konfiguračním datům aplikací, které podporují ACAP, z jakéhokoli počítače připojeného k síti .  Protokol je založen na IMAP4 .

Popis protokolu

Relace protokolu ACAP zahrnuje navázání připojení TCP, úvodní pozdrav ze serveru a interakci klient-server, která zahrnuje příkazy klienta, výsledky provádění a data ze serveru. Protokol ACAP je textový protokol, příkazy a data přenášená mezi klientem a serverem jsou buď posloupností znaků zakončených znaky na konci řádku ( CR LF ) nebo posloupností oktetů známé délky.

Klientské příkazy začínají identifikátorem (alfanumerický řetězec o délce až 32 znaků), který se nazývá příznak. Každý přenášený příkaz musí mít jedinečný tag. Klient může odesílat příkazy, aniž by čekal na odpověď serveru na předchozí příkaz.

Odpověď serveru může být:

• požadavek na pokračování příkazu začíná symbolem „+“;
• výsledek provedení příkazu začíná stejnou značkou jako příkaz klienta, který operaci spustil, následuje kód odezvy serveru:
  • OK - úspěšné provedení;
  • NE - příkaz nebyl proveden;
  • BAD - příkaz nebyl rozpoznán nebo chyba syntaxe;
• mezilehlá odpověď, začíná stejnou značkou jako příkaz, který ji vyvolal, následuje kód odpovědi (kromě OK, NE, BAD);
• neoznačená odpověď začíná znakem "*" a vrací zprávu nebo data, která lze interpretovat mimo kontext prováděných příkazů.

Data jsou uložena na serveru ve formě hierarchického stromu. Každá úroveň hierarchie se nazývá datová sada a skládá se ze seznamu uzlů. Uzly mají jedinečný název a mohou obsahovat libovolný počet pojmenovaných atributů. Atributy mají jednu nebo více hodnot a souvisejících metadat .

Formát dat

Přenášená data mohou být v jednom z pěti formátů:

• atom - skládá se z nespeciálních znaků (od 1 do 1024) a musí začínat písmenem, používaným pro klíčová slova protokolu;
• číslo - skládá se z číselných znaků, velikost je omezena na 32bitové číslo bez znaménka;
• řetězec - může mít dvě formy reprezentace:
  • doslovný:
    • synchronizovaný literál - začíná přenosem počtu oktetů ve složených závorkách a znacích na konci řádku, po obdržení požadavku ze serveru na pokračování jsou data odeslána;
    • nesynchronizovaný literál je počet oktetů ve složených závorkách se znaménkem plus mezi číslem a uzavírací závorkou, za nímž následují data končící na konci řádku;
  • citovaný řetězec — řetězec délky od nuly do 1024 oktetů, kromě znaku s kódem nula a konce řetězce, uzavřený v uvozovkách;
• seznam - posloupnost prvků oddělených mezerami, uzavřená v závorkách, seznam může být prázdný nebo může mít několik úrovní vnoření;
• prázdný prvek je speciální atom NIL.

Uzly a jejich atributy

Pro vytvoření úplné cesty k uzlu jsou názvy uzlů různých úrovní odděleny lomítkem. Atributy mají hierarchické názvy skládající se z komponent oddělených tečkami. Názvy atributů, které neobsahují tečku, jsou vyhrazeny pro standardní atributy, které mají hodnotu v jakékoli datové množině. Hodnota atributu může být NIL (atribut nemá žádné hodnoty), řetězec (jedna hodnota) nebo sada řetězců (více hodnot).

Protokol definuje následující atributy:

• záznam - název atributu;
• modtime - datum a čas poslední úpravy metadat v uzlu, 14 a více číslic ve formátu ASCII;
• subdataset - sada, pokud má uzel podkladovou datovou sadu, hodnota atributu je seznam relativních URL označujících umístění datové sady (tečka "." znamená datovou sadu bezprostředně pod daným uzlem).

Metadata popisují atribut, jeho hodnoty a řízení přístupu. Protokol definuje následující prvky metadat:

• acl - seznam přístupových práv k atributu;
• atribut - název atributu;
• myrights - soubor klientských práv;
• velikost je délka hodnoty atributu; pokud má atribut více hodnot, pak sadu délek pro každou hodnotu;
• hodnota je hodnota atributu nebo sada hodnot.

Příkazy

Mezi příkazy protokolu patří:

• autentizační příkaz;
• vyhledávací příkazy;
• kontextové příkazy (správa množiny uzlů vybraných podle určitých kritérií a existujících během relace);
• příkazy pro úpravu datové sady;
• příkazy pro změnu přístupových práv;
• příkazy pro správu kvót
• další příkazy (žádná operace, výběr preferovaného jazyka, odhlášení).

Schéma URL

ACAP URL je ve formátu: acap:// url-server / url-enc-entry [url-filter] [url-extension]

• url-server - obsahuje název serveru a volitelně uživatelské jméno, mechanismus ověřování a číslo portu;
• url-enc-entry - název hostitele;
• url-filter - seznam jmen atributů; pokud chybí, pak se URL vztahuje na všechny atributy;
• url-extension – vyhrazeno pro budoucí rozšíření.

RFC standardy

• RFC 2244