Protocolul de acces la configurația aplicației

Application Configuration Access Protocol ( ACAP) este un protocol de rețea care permite utilizatorului să acceseze datele de configurare ale aplicațiilor care acceptă ACAP de pe orice computer conectat la rețea .  Protocolul se bazează pe IMAP4 .

Descrierea protocolului

O sesiune de protocol ACAP include stabilirea unei conexiuni TCP, un salut inițial de la server și interacțiunea client-server care include comenzi client, rezultate de execuție și date de la server. Protocolul ACAP este un protocol text, comenzile și datele transmise între client și server sunt fie o secvență de caractere terminată cu caractere de sfârșit de linie ( CR LF ), fie o secvență de octeți de lungime cunoscută.

Comenzile client încep cu un identificator (un șir alfanumeric de până la 32 de caractere) numit flag. Fiecare comandă transmisă trebuie să aibă o etichetă unică. Comenzile pot fi trimise de client fără a aștepta răspunsul serverului la comanda anterioară.

Răspunsul serverului poate fi:

• o solicitare de a continua comanda, începe cu simbolul „+”;
• rezultatul executării comenzii începe cu același semn ca și comanda client care a început operația, urmat de codul de răspuns al serverului:
  • OK - execuție cu succes;
  • NU - comanda nu a fost executată;
  • BAD - comandă nerecunoscută sau eroare de sintaxă;
• răspunsul intermediar, începe cu același semn ca și comanda care l-a numit, urmat de codul de răspuns (excluzând OK, NU, RĂU);
• un răspuns nemarcat, începe cu caracterul „*” și returnează un mesaj sau date care pot fi interpretate în afara contextului comenzilor executate.

Datele sunt stocate pe server sub forma unui arbore ierarhic. Fiecare nivel al ierarhiei se numește set de date și constă dintr-o listă de noduri. Nodurile au un nume unic și pot conține orice număr de atribute numite. Atributele au una sau mai multe valori și metadate asociate .

Formatul datelor

Datele transmise pot fi în unul dintre cele cinci formate:

• atom - este format din caractere nespeciale (de la 1 la 1024) și trebuie să înceapă cu o literă, folosită pentru cuvintele cheie de protocol;
• număr - este format din caractere numerice, dimensiunea este limitată la un număr nesemnat de 32 de biți;
• șir - poate avea două forme de reprezentare:
  • literal:
    • literal sincronizat - începe cu transferul numărului de octeți în acolade și caractere de sfârșit de linie, după primirea unei cereri de la server pentru a continua, datele sunt trimise;
    • un literal nesincronizat este numărul de octeți în acolade, cu un semn plus între număr și acolade de închidere, urmat de datele care se termină la sfârșitul liniei;
  • șir ghilime — un șir de lungime de la zero la 1024 de octeți, excluzând caracterul cu codul zero și sfârșitul șirului, cuprins între ghilimele duble;
• listă - o succesiune de elemente separate prin spații, cuprinse între paranteze, lista poate fi goală sau poate avea mai multe niveluri de imbricare;
• un element gol este un atom NIL special.

Nodurile și atributele lor

Pentru a forma o cale completă către un nod, numele nodurilor de diferite niveluri sunt separate printr-o bară oblică. Atributele au nume ierarhice constând din componente separate prin puncte. Numele de atribute care nu conțin un punct sunt rezervate pentru atributele standard care au o valoare în orice set de date. Valoarea unui atribut poate fi NIL (atributul nu are valori), un șir (o singură valoare) sau un set de șiruri (valori multiple).

Protocolul definește următoarele atribute:

• intrare - nume atribut;
• modtime - data și ora ultimei modificări a metadatelor din nod, 14 sau mai multe cifre în format ASCII;
• subdataset - setat dacă nodul are un set de date subiacent, valoarea atributului este o listă de adrese URL relative care indică locația setului de date (punctul "." înseamnă setul de date imediat sub nodul dat).

Metadatele descriu un atribut, valorile acestuia și controlul accesului. Protocolul definește următoarele elemente de metadate:

• acl - lista drepturilor de acces la atribut;
• atribut - nume de atribut;
• myrights - un set de drepturi ale clientului;
• dimensiunea este lungimea valorii atributului; dacă atributul are mai multe valori, atunci un set de lungimi pentru fiecare valoare;
• valoare este valoarea atributului sau setul de valori.

Comenzi

Comenzile de protocol includ:

• comanda de autentificare;
• comenzi de căutare;
• comenzi de context (managementul unui set de noduri selectate după anumite criterii și existente în timpul sesiunii);
• comenzi de modificare a setului de date;
• comenzi pentru modificarea drepturilor de acces;
• comenzi de gestionare a cotelor
• alte comenzi (fără operare, selecție limbii preferate, deconectare).

Schema URL

URL-ul ACAP este în formatul: acap:// url-server / url-enc-entry [url-filter] [url-extension]

• url-server - include numele serverului și opțional numele de utilizator, mecanismul de autentificare și numărul portului;
• url-enc-entry - numele gazdei;
• url-filter - lista de nume de atribute; dacă lipsește, atunci URL-ul se aplică tuturor atributelor;
• url-extension - rezervat pentru extensiile viitoare.

Standarde RFC

• RFC 2244