Toegangsprotocol voor toepassingsconfiguratie

EEN PET
Naam	Toegangsprotocol voor toepassingsconfiguratie
Niveau (volgens het OSI-model )	Toegepast
Familie	TCP/IP
Gemaakt in	1997
Poort/ID	674/ TCP
Doel van het protocol	Externe opslag van configuratiegegevens
Specificatie	RFC 2244

Application Configuration Access Protocol ( ACAP) is een netwerkprotocol waarmee de gebruiker vanaf elke op het netwerk aangesloten computer toegang heeft tot de configuratiegegevens van toepassingen die ACAP ondersteunen .  Het protocol is gebaseerd op IMAP4 .

Beschrijving van het protocol

Een ACAP-protocolsessie omvat het tot stand brengen van een TCP-verbinding, een eerste hallo van de server en client-serverinteractie die clientopdrachten, uitvoeringsresultaten en gegevens van de server omvat. Het ACAP-protocol is een tekstprotocol. De opdrachten en gegevens die tussen de client en de server worden verzonden, zijn ofwel een reeks tekens die worden afgesloten met end-of-line-tekens ( CR LF ) of een reeks octetten van bekende lengte.

Clientopdrachten beginnen met een identifier (een alfanumerieke reeks van maximaal 32 tekens) die een vlag wordt genoemd. Elk verzonden commando moet een unieke tag hebben. Opdrachten kunnen door de client worden verzonden zonder te wachten op de reactie van de server op de vorige opdracht.

De serverreactie kan zijn:

• een verzoek om de opdracht voort te zetten, begint met het "+"-symbool;
• het resultaat van het uitvoeren van de opdracht begint met hetzelfde teken als de clientopdracht waarmee de bewerking is gestart, gevolgd door de antwoordcode van de server:
  • OK - succesvolle uitvoering;
  • NEE - de opdracht is niet uitgevoerd;
  • BAD - opdracht niet herkend of syntaxisfout;
• tussenantwoord, begint met hetzelfde teken als het commando dat het aanriep, gevolgd door de antwoordcode (exclusief OK, NO, BAD);
• een ongemarkeerd antwoord, begint met het teken "*" en retourneert een bericht of gegevens die kunnen worden geïnterpreteerd buiten de context van de opdrachten die worden uitgevoerd.

De gegevens worden in de vorm van een hiërarchische boom op de server opgeslagen. Elk niveau van de hiërarchie wordt een dataset genoemd en bestaat uit een lijst met knooppunten. Knooppunten hebben een unieke naam en kunnen een willekeurig aantal benoemde attributen bevatten. Attributen hebben een of meer waarden en bijbehorende metadata .

Gegevensformaat

De verzonden gegevens kunnen in een van de vijf formaten zijn:

• atoom - bestaat uit niet-speciale tekens (van 1 tot 1024) en moet beginnen met een letter, gebruikt voor protocolsleutelwoorden;
• nummer - bestaat uit numerieke tekens, de grootte is beperkt tot een niet-ondertekend 32-bits nummer;
• string - kan twee vormen van representatie hebben:
  • letterlijk:
    • gesynchroniseerde letterlijke - begint met de overdracht van het aantal octetten tussen accolades en einde-regeltekens, na ontvangst van een verzoek van de server om door te gaan, worden gegevens verzonden;
    • een niet-gesynchroniseerde letterlijke is het aantal octetten tussen accolades, met een plusteken tussen het nummer en de afsluitende accolade, gevolgd door gegevens die aan het einde van de regel eindigen;
  • string met aanhalingstekens — een string met een lengte van nul tot 1024 octetten, exclusief het teken met code nul en het einde van de string, tussen dubbele aanhalingstekens;
• lijst - een reeks elementen gescheiden door spaties, tussen haakjes ingesloten, de lijst kan leeg zijn of meerdere nestniveaus hebben;
• een leeg element is een speciaal NIL-atoom.

Knooppunten en hun attributen

Om een ​​volledig pad naar een knooppunt te vormen, worden de namen van knooppunten van verschillende niveaus gescheiden door een schuine streep. Attributen hebben hiërarchische namen die bestaan ​​uit door punten gescheiden componenten. Attribuutnamen die geen punt bevatten, zijn gereserveerd voor standaardattributen die een waarde hebben in een dataset. De waarde van een kenmerk kan NIL zijn (het kenmerk heeft geen waarden), een tekenreeks (enkele waarde) of een reeks tekenreeksen (meerdere waarden).

Het protocol definieert de volgende kenmerken:

• invoer - attribuutnaam;
• modtime - datum en tijd van de laatste wijziging van de metadata in het knooppunt, 14 of meer cijfers in ASCII-formaat;
• subdataset - ingesteld als het knooppunt een onderliggende dataset heeft, is de waarde van het kenmerk een lijst van relatieve URL's die de locatie van de dataset aangeven (de punt "." betekent de dataset direct onder het gegeven knooppunt).

Metadata beschrijven een attribuut, zijn waarden en toegangscontrole. Het protocol definieert de volgende metadata-elementen:

• acl - lijst met toegangsrechten tot het attribuut;
• attribuut - attribuutnaam;
• myrights - een reeks klantrechten;
• grootte is de lengte van de attribuutwaarde; als het attribuut meerdere waarden heeft, dan een reeks lengtes voor elke waarde;
• waarde is de attribuutwaarde of reeks waarden.

Commando's

Protocolopdrachten omvatten:

• authenticatie commando;
• zoekopdrachten;
• contextopdrachten (beheer van een reeks knooppunten geselecteerd volgens bepaalde criteria en bestaande tijdens de sessie);
• commando's voor het wijzigen van gegevenssets;
• opdrachten voor het wijzigen van toegangsrechten;
• quotabeheeropdrachten
• andere commando's (geen bediening, voorkeurstaal selecteren, uitloggen).

URL-schema

De ACAP-URL heeft de volgende indeling: acap:// url-server / url-enc-entry [url-filter] [url-extensie]

• url-server - bevat de servernaam en optioneel de gebruikersnaam, het authenticatiemechanisme en het poortnummer;
• url-enc-entry - hostnaam;
• url-filter - lijst met attribuutnamen; indien afwezig, dan geldt de URL voor alle attributen;
• url-extensie - gereserveerd voor toekomstige extensies.

RFC-standaarden

• RFC 2244