fix(examples): use credentials_and_ip instead of ip_only for trunk creation

ip_only authentication is read-only and can only be configured by DIDWW
staff. The example now creates trunks with credentials_and_ip, which is
settable via the API. Added docstring to IpOnlyAuthenticationMethod
documenting its read-only nature.

Author: Fivell

examples/voice_out_trunks.py

@@ -34,11 +34,12 @@
     print(f"    RTP Timeout: {t.rtp_timeout}")
     print()
 
-# Create a voice out trunk with ip_only authentication
-print("=== Creating Voice Out Trunk (ip_only) ===")
+# Create a voice out trunk with credentials_and_ip authentication
+# Note: ip_only authentication can only be configured by DIDWW staff.
+print("=== Creating Voice Out Trunk (credentials_and_ip) ===")
 trunk = VoiceOutTrunk()
 trunk.name = f"My Outbound Trunk {suffix}"
-trunk.authentication_method = IpOnlyAuthenticationMethod(
+trunk.authentication_method = CredentialsAndIpAuthenticationMethod(
     allowed_sip_ips=["203.0.113.0/24"],
     tech_prefix="",
 )
@@ -51,11 +52,13 @@
 print(f"  Name: {created.name}")
 auth = created.authentication_method
 print(f"  Auth type: {auth.type if auth else None}")
+if isinstance(auth, CredentialsAndIpAuthenticationMethod):
+    print(f"  Username: {auth.username}")
 print(f"  Status: {created.status}")
 print(f"  External Reference: {created.external_reference_id}")
 
-# Update - switch to credentials_and_ip
-print("\n=== Updating Voice Out Trunk (switch to credentials_and_ip) ===")
+# Update - change name and tech_prefix
+print("\n=== Updating Voice Out Trunk ===")
 update = VoiceOutTrunk.build(created.id)
 update.name = f"Updated Outbound Trunk {suffix}"
 update.authentication_method = CredentialsAndIpAuthenticationMethod(

src/didww/resources/authentication_method.py

@@ -46,6 +46,13 @@ def _plain(key):
 
 
 class IpOnlyAuthenticationMethod(AuthenticationMethod):
+    """Read-only authentication method for VoiceOutTrunk.
+
+    ip_only authentication can only be configured manually by DIDWW staff
+    upon request. It cannot be set via the API on create or update.
+    Trunks with ip_only authentication can still be read and their
+    non-authentication attributes updated via the API.
+    """
     _type = "ip_only"
 
     allowed_sip_ips = _plain("allowed_sip_ips")