FreeIPA JSONRPC-API mit PHP verwenden

class: center, middle

# FreeIPA JSONRPC-API mit PHP verwenden
### Hauke Goos-Habermann
#### https://goos-habermann.de

---

### Über mich

- Entwickler des Softwareverteilungssystems m23

- Organisator der Kieler Open Source und Linux Tage

- Dienstleister zu m23, Linux und Freier Software

- Softwareentwicklung (PHP, BASH, C/C++, JS, Python und was sonst so gebraucht wird...)
  - Administration
  - Schulungen
  - Support
  - Beratung
  - quasi **alles**, *was mit Linux zu tun hat*

- Aktuell: Neues Kundenprojekt auf Basis von AlmaLinux

---

### Pakete installieren

Zum schnellen Testen installieren wird die Kommandozeilenversion von PHP und die dazugehörige curl-Erweiterung.

```bash
apt-get -y install php-cli php-curl
```
---

### PHP

```php
<?php
function curlExec($cs, $post, $json = true)
	{
		$ipaServer = 'ipa.almalinux.local';
		$cookieFile = 'cookies.txt';
	
		// Sende- und Empfangsformat für die Datenübertragung vom und zum FreeIPA-Server festlegen
		if ($json)
		{
			$headers[] = 'Content-Type:application/json';
			$headers[] = 'Accept:applicaton/json';
			$url = "https://$ipaServer/ipa/session/json";
		}
		else
		{
			$headers[] = 'Content-Type:application/x-www-form-urlencoded';
			$headers[] = 'Accept:text/plain';
			$url = "https://$ipaServer/ipa/session/login_password";
		}

// API URL des FreeIPA-Servers öffnen
		curl_setopt($ch, CURLOPT_URL, $url);

// Referer setzen (wird aus Sicherheitsgründen benötigt)
		curl_setopt($ch, CURLOPT_REFERER, "https://$ipaServer/ipa/");

// Vom FreeIPA-Server empfangene Daten (JSON oder HTML) erhalten
		curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
	
		// Sende- und Empfangsformat für die Datenübertragung setzen
		curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

// Cookies speichern (wird benötigt, um nach der Authentifizierung weitere Befehle zu senden)
		curl_setopt($ch, CURLOPT_COOKIEFILE, $cookieFile);
		curl_setopt($ch, CURLOPT_COOKIEJAR, $cookieFile);
	
		// Das SSL-Zertifikat des FreeIPA-Servers nicht überprüfen
		curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
	
		// Daten per POST übertragen
		curl_setopt($ch, CURLOPT_POST, true);
		curl_setopt($ch, CURLOPT_POSTFIELDS, $post);

// Debug
//	 	curl_setopt($ch, CURLOPT_HEADER, true);
//	 	curl_setopt($ch, CURLOPT_VERBOSE, true);

// Alles an den FreeIPA-Server übertragen unn das Ergebnis empfangen
		$ret = curl_exec($ch);

if ($json)
			// JSON-Daten in ein Assoziatives Array umwandeln
			return(json_decode($ret, true));
		else
			// Andere Daten (HTML) direkt zurückgeben
			return($ret);
	}
?>
```
---

### Vom ipa-Aufruf zu JSON-Parametern

```bash

# Kerberos-Ticket holen, wen kein gültiges vorhanden ist
if ! klist -s
then
	kinit admin
fi

# DNS-Einstrag eines Rechners löschen
ipa -vv dnsrecord-del --del-all almalinux.local muh4
```

```json
{
	"id": 0,
	"method": "dnsrecord_del/1",
	"params": [
		[
			"almalinux.local",
			{
				"__dns_name__": "ipatest4"
			}
		],
		{
			"del_all": true,
			"version": "2.239"
		}
	]
}
```
---

### Vom ipa-Aufruf zu JSON-Parametern

**,
"version" ...** und **/1** entfernen. PHP-Variablen einfügen:

```php
$domain = 'almalinux.local';
$client = 'ipatest4';

$q = '{
	"id": 0,
	"method": "dnsrecord_del",
	"params": [
		[
			"'.$domain.'",
			{
				"__dns_name__": "'.$client.'"
			}
		],
		{
			"del_all": true
		}
	]
}';
```
---

class: center, middle
### Informationen zu mir und meinen Dienstleistungen, m23, ...
### https://goos-habermann.de