ipa - Online in de cloud

PROGRAMMA:

NAAM

ipa - IPA-opdrachtregelinterface

KORTE INHOUD

ipa [opties] [-c FILE] [-e SLEUTEL=VAL] COMMAND [parameters]

PRODUCTBESCHRIJVING

IPA is een geïntegreerde oplossing voor beveiligingsinformatiebeheer op basis van 389 Directory
Server (voorheen bekend als Fedora Directory Server), MIT Kerberos, Dogtag-certificaat
Systeem, NTP en DNS. Het bevat een webinterface en opdrachtregelbeheertools voor
identiteitsgegevens beheren.

Deze handleidingpagina richt zich op de ipa script dat dient als de belangrijkste opdrachtregelinterface
(CLI) voor IPA-administratie.

Meer informatie over het project is beschikbaar op de homepage op
http://www.freeipa.org.

OPTIES

-c FILE
Configuratie laden van FILE.

-d, --debuggen
Produceer volledige foutopsporingsuitvoer.

--delegeren
Delegeer de TGT van de gebruiker naar de IPA-server

-e SLEUTEL=VAL
Omgevingsvariabele instellen KEY naar de waarde VAL. Deze optie overschrijft
configuratiebestanden.

-h, --help
Geef een helpbericht weer met een lijst met opties.

-n, --geen prompt
Vraag niet om parameters van COMMAND, zelfs als ze nodig zijn.

-a, --prompt-allen
Vragen om alle parameters van COMMAND, zelfs als ze optioneel zijn.

-f, --geen terugval
Val niet terug op andere IPA-servers als de standaard niet werkt.

-v, --uitgebreid
Produceer uitgebreide uitvoer. Een tweede -v pretty-drukt het JSON-verzoek en antwoord af. A
derde -v geeft het HTTP-verzoek en antwoord weer.

--versie
Geef de IPA-versie en API-versie weer.

COMMANDO'S

De belangrijkste functie van de CLI is het uitvoeren van administratieve opdrachten die zijn opgegeven door de
COMMAND argument. De meeste opdrachten worden op afstand uitgevoerd via XML-RPC op een IPA
server vermeld in het configuratiebestand (zie het gedeelte BESTANDEN van deze handleidingpagina).

Vanuit het implementatieperspectief onderscheidt de CLI twee soorten opdrachten:
ingebouwde ins en plug-in aanwezig.

Ingebouwde commando's zijn statisch en zijn allemaal beschikbaar in alle installaties van IPA. Er zijn
twee van hen:

console
Start de IPA interactieve Python-console.

hulp [TOPIC | COMMAND | onderwerpen | commando's]
Help voor een opdracht of onderwerp weergeven.

De hulp opdracht roept het ingebouwde documentatiesysteem op. Zonder parameters a
lijst met ingebouwde opdrachten en helponderwerpen wordt weergegeven. Help-onderwerpen worden gegenereerd
van geladen IPA-plug-inmodules. Uitvoeren hulp met de naam van een beschikbaar onderwerp
geeft een hulpbericht weer dat wordt geleverd door de bijbehorende plug-inmodule en een lijst met
opdrachten die erin staan.

Door plug-ins geleverde opdrachten zijn, zoals de naam al doet vermoeden, afkomstig van IPA-plug-inmodules. De
beschikbare set kan variëren afhankelijk van uw configuratie en kan worden vermeld met behulp van de
ingebouwd hulp opdracht (zie hierboven).

De meeste door plug-ins geleverde opdrachten zijn gekoppeld aan een bepaald type IPA-object. IPA-objecten
omvatten gemeenschappelijke abstracties zoals gebruikers (gebruikersidentiteiten/accounts), hosts (machine
identiteiten), services, wachtwoordbeleid, enz. Commando's die aan een object zijn gekoppeld, zijn
gemakkelijk te herkennen dankzij de opgelegde naamgevingsconventie; de opdrachtnamen zijn samengesteld
uit twee delen gescheiden door een streepje: de naam van het overeenkomstige IPA-objecttype en de
naam van de actie die erop is uitgevoerd. Bijvoorbeeld alle opdrachten die worden gebruikt om gebruikersidentiteiten te beheren
beginnen met "user-" (bijv. user-add, user-del).

De volgende acties zijn beschikbaar voor de meeste IPA-objecttypen:

toevoegen [HOOFDSLEUTEL] [opties]
Maak een nieuw voorwerp aan.

tonen [HOOFDSLEUTEL] [opties]
Geef een bestaand object weer.

mod [HOOFDSLEUTEL] [opties]
Wijzig een bestaand object.

del [HOOFDSLEUTEL]
Verwijder een bestaand object.

vinden [CRITERIA] [opties]
Zoeken naar bestaande objecten.

De bovenstaande typen opdrachten behalve vinden neem de primaire sleutel van het object (bijv. gebruikersnaam voor
gebruikers) als hun enige positionele argument, tenzij er slechts één object van het gegeven kan zijn
type. Ze kunnen ook een aantal opties kiezen (waarvan sommige in het geval nodig kunnen zijn).
of toevoegen) die de objectattributen vertegenwoordigen.

vinden commando's nemen een optionele criteriareeks als hun enige positionele argument. Als
aanwezig zijn, worden alle objecten weergegeven met een attribuut dat de criteriareeks bevat. Als
een optie die een attribuut vertegenwoordigt is ingesteld, alleen object met het attribuut precies
die overeenkomen met de opgegeven waarde worden weergegeven. Opties met lege waarden worden genegeerd. Zonder
parameters worden alle objecten van het overeenkomstige type weergegeven.

Voor IPA-objecten met attributen die verwijzingen naar andere objecten kunnen bevatten (bijv
groepen), zijn meestal de volgende acties beschikbaar:

lid toevoegen [HOOFDSLEUTEL] [opties]
Voeg verwijzingen naar andere objecten toe.

lid verwijderen [HOOFDSLEUTEL] [opties]
Verwijder verwijzingen naar andere objecten.

De bovenstaande soorten commando's nemen de primaire sleutel van het object als hun enige positionele argument
tenzij er slechts één object van het gegeven type kan zijn. Ze nemen ook een aantal opties
die lijsten van andere primaire objectsleutels vertegenwoordigen. Elk van deze opties vertegenwoordigt er één
soort voorwerp.

Voor sommige soorten objecten hebben deze opdrachten mogelijk meer dan één primaire sleutel nodig.
Dit is van toepassing op IPA-objecten die zijn georganiseerd in hiërarchieën waar het bovenliggende object zich moet bevinden
als eerste geïdentificeerd. Bovenliggende primaire sleutels worden altijd links uitgelijnd (hoger in het
hiërarchie = meer naar links). De automount IPA-plug-in stelt gebruikers bijvoorbeeld in staat om
beheer automount-kaarten per locatie, als resultaat nemen alle automount-commando's een
automountlocation primaire sleutel als hun eerste positionele argument.

Alle opdrachten die objecten weergeven, hebben drie speciale opties voor het regelen van uitvoer:

--alle Geef alle attributen weer. Zonder deze optie zijn alleen de meest relevante attributen
weergegeven.

--rauw Geef objecten weer zoals ze zijn opgeslagen in de backing store. Schakelt formatteren uit en
attribuut labels.

--rechten
Toon effectieve rechten op alle attributen van het item. Je moet ook specificeren
--alle om dit te laten werken. Gebruikersrechten worden geretourneerd als Python-woordenboek waar index
is de naam van een attribuut en waarde is een samengestelde Unicode-string (vandaar de
u'xxxx' formaat) van onderstaande letters. Merk op dat gebruikersrechten in de eerste plaats zijn
gebruikt voor interne doeleinden van CLI en WebUI.

r - lees
s - zoeken
w - schrijf
o - uitwissen (verwijderen)
c - vergelijk
W - zelf schrijven
O - zelfvernietiging

Voorbeelden

ipa hulp commando's
Geef een lijst met beschikbare opdrachten weer ipa hulp onderwerpen Toon een lijst op hoog niveau van
hulponderwerpen ipa hulp gebruiker Documentatie en lijst met opdrachten weergeven in de "gebruiker"
topic.

ipa env
Maak een lijst van IPA-omgevingsvariabelen en hun waarden.

ipa gebruiker-toevoegen foo --eerst foo --laatste bars
Maak een nieuwe gebruiker aan met gebruikersnaam "foo", voornaam "foo" en achternaam "bar".

ipa groep-toevoegen bars --beschrijf "dit is an voorbeeld groep"
Maak een nieuwe groep aan met naam "bar" en omschrijving "dit is een voorbeeldgroep".

ipa groep-toevoegen-lid bars --users=foe
Voeg gebruiker "foo" toe aan de groep "bar".

ipa groep-toevoegen-lid bars --users={beheerder,foo}
Voeg gebruikers "admin" en "foo" toe aan de groep "bar". Deze aanpak is afhankelijk van shell
uitbreidingsfunctie.

ipa gebruikersshow foo --rauw
Geef gebruiker "foo" weer zoals hij of zij op de server is opgeslagen.

ipa groepsshow bars --alle
Toon groep "bar" en al zijn attributen.

ipa configuratie-mod --maxgebruikersnaam 20
Stel de maximale lengte van de gebruikersnaam in op 20 tekens.

ipa gebruiker-vinden foo
Zoek naar alle gebruikers met "foo" in uid, voornaam, achternaam, volledige naam,
etc. Een gebruiker met uid "foobar" zou voldoen aan de zoekcriteria.

ipa gebruiker-vinden foo --eerst bars
Hetzelfde als het vorige voorbeeld, behalve dat deze keer de voornaam van de gebruiker moet zijn
precies "bar". Een gebruiker met uid "foobar" en voornaam "bar" komt overeen met de zoekopdracht
criteria.

ipa gebruiker-vinden foo --eerst bars --laatste foo
Een gebruiker met uid "foobar", voornaam "bar" en achternaam "foo" zou overeenkomen met de
zoekcriteria.

ipa gebruiker-vinden --uuid 936407bd-da9b-11de-9abd-54520012e7cd
Alleen de gebruiker met de opgegeven unieke IPA-ID komt overeen met de zoekcriteria.

ipa gebruiker-vinden
Alle gebruikers zouden voldoen aan de zoekcriteria (aangezien er geen zijn).

SERVERS

De ipa-client bepaalt in deze volgorde met welke server verbinding moet worden gemaakt:

1. De server die is geconfigureerd in /etc/ipa/default.conf in de xmlrpc_uri Richtlijn.

2. Een ongeordende lijst met servers uit de ldap DNS SRV-records.

Als een Kerberos-fout wordt veroorzaakt door een van de verzoeken, stopt het met verwerken en
de foutmelding weergeven.

Gebruik ipa online met behulp van onworks.net-services