🖥️ Cisco Compute & Collaboration

#!/usr/bin/env python3
"""
Cisco Webex Teams SDK Example
Demonstrates messaging and space management
"""

from webexteamssdk import WebexTeamsAPI

# Initialize API
api = WebexTeamsAPI(access_token="YOUR_ACCESS_TOKEN")

# List all spaces (rooms)
def list_spaces():
    """List all Webex spaces"""
    print("="*70)
    print("WEBEX SPACES")
    print("="*70)
    
    spaces = api.rooms.list()
    
    for space in spaces:
        print(f"\nSpace: {space.title}")
        print(f"  ID: {space.id}")
        print(f"  Type: {space.type}")
        print(f"  Created: {space.created}")
    
    return list(spaces)

# Create a new space
def create_space(title):
    """Create a new Webex space"""
    space = api.rooms.create(title=title)
    print(f"✅ Space '{title}' created: {space.id}")
    return space

# Send a message
def send_message(room_id, text):
    """Send message to a space"""
    message = api.messages.create(
        roomId=room_id,
        text=text
    )
    print(f"✅ Message sent: {message.id}")
    return message

# Send message with attachment
def send_message_with_file(room_id, text, file_url):
    """Send message with file attachment"""
    message = api.messages.create(
        roomId=room_id,
        text=text,
        files=[file_url]
    )
    print(f"✅ Message with file sent")
    return message

# List messages in a space
def list_messages(room_id, max_messages=10):
    """List recent messages in a space"""
    print(f"\nMessages in space (last {max_messages}):")
    
    messages = api.messages.list(
        roomId=room_id,
        max=max_messages
    )
    
    for msg in messages:
        print(f"\n  From: {msg.personEmail}")
        print(f"  Text: {msg.text}")
        print(f"  Time: {msg.created}")
    
    return list(messages)

# Create a webhook
def create_webhook(name, target_url, resource, event):
    """Create a webhook for real-time events"""
    webhook = api.webhooks.create(
        name=name,
        targetUrl=target_url,
        resource=resource,
        event=event
    )
    print(f"✅ Webhook created: {webhook.id}")
    return webhook

# List people
def list_people(email=None, display_name=None):
    """Search for people"""
    if email:
        people = api.people.list(email=email)
    elif display_name:
        people = api.people.list(displayName=display_name)
    else:
        people = api.people.list(max=10)
    
    print("\nPeople:")
    for person in people:
        print(f"  {person.displayName} ({person.emails[0]})")
    
    return list(people)

# Main execution
if __name__ == "__main__":
    # List spaces
    spaces = list_spaces()
    
    # Create a space
    new_space = create_space("DevOps Team")
    
    # Send message
    send_message(new_space.id, "Hello from Python!")
    
    print("\n✅ Webex operations complete")

# Webex Devices API Example
import requests

# List all devices
def list_devices(access_token):
    """List all Webex devices in organization"""
    url = "https://webexapis.com/v1/devices"
    headers = {"Authorization": f"Bearer {access_token}"}
    
    response = requests.get(url, headers=headers)
    devices = response.json()
    
    for device in devices.get('items', []):
        print(f"Device: {device['displayName']}")
        print(f"  Product: {device['product']}")
        print(f"  Status: {device['connectionStatus']}")
        print(f"  IP: {device.get('ip', 'N/A')}")

# Send command to device (xAPI)
def send_xapi_command(device_id, access_token, command):
    """Execute xAPI command on device"""
    url = f"https://webexapis.com/v1/xapi/command/{command}"
    headers = {"Authorization": f"Bearer {access_token}"}
    data = {"deviceId": device_id}
    
    response = requests.post(url, headers=headers, json=data)
    return response.json()

#!/usr/bin/env python3
"""
CUCM AXL API Example
Administrative operations using SOAP
"""

from zeep import Client
from zeep.transports import Transport
from requests import Session
from requests.auth import HTTPBasicAuth
import urllib3

# Disable SSL warnings (for lab environments)
urllib3.disable_warnings(urllib3.exceptions.InsecureRequestWarning)

class CUCMAxl:
    """CUCM AXL API Client"""
    
    def __init__(self, host, username, password, version='12.5'):
        self.host = host
        self.username = username
        self.password = password
        self.version = version
        
        # Setup SOAP client
        wsdl = f'https://{host}:8443/axl/DB/{version}/AXLAPI.wsdl'
        session = Session()
        session.auth = HTTPBasicAuth(username, password)
        session.verify = False
        
        transport = Transport(session=session, timeout=10)
        self.client = Client(wsdl, transport=transport)
        self.service = self.client.create_service(
            "{http://www.cisco.com/AXLAPIService/}AXLAPIBinding",
            f'https://{host}:8443/axl/'
        )
    
    def list_phones(self):
        """List all IP phones"""
        try:
            resp = self.service.listPhone(
                searchCriteria={'name': '%'},
                returnedTags={'name': '', 'model': '', 'description': ''}
            )
            
            print("="*70)
            print("CUCM IP PHONES")
            print("="*70)
            
            if resp['return']:
                for phone in resp['return']['phone']:
                    print(f"\nPhone: {phone['name']}")
                    print(f"  Model: {phone['model']}")
                    print(f"  Description: {phone.get('description', 'N/A')}")
            
            return resp['return']['phone'] if resp['return'] else []
            
        except Exception as e:
            print(f"❌ Error: {e}")
            return []
    
    def get_phone(self, name):
        """Get specific phone details"""
        try:
            resp = self.service.getPhone(name=name)
            phone = resp['return']['phone']
            
            print(f"\nPhone Details: {name}")
            print(f"  Model: {phone['model']}")
            print(f"  Description: {phone.get('description', 'N/A')}")
            print(f"  Device Pool: {phone['devicePoolName']['_value_1']}")
            print(f"  CSS: {phone.get('callingSearchSpaceName', {}).get('_value_1', 'N/A')}")
            
            return phone
            
        except Exception as e:
            print(f"❌ Error: {e}")
            return None
    
    def add_phone(self, name, description, model='Cisco 8861'):
        """Add a new IP phone"""
        try:
            phone_data = {
                'name': name,
                'description': description,
                'product': model,
                'devicePoolName': 'Default',
                'locationName': 'Hub_None',
                'class': 'Phone',
                'protocol': 'SIP',
                'protocolSide': 'User',
                'commonPhoneConfigName': 'Standard Common Phone Profile'
            }
            
            resp = self.service.addPhone(phone_data)
            print(f"✅ Phone '{name}' added successfully")
            return resp
            
        except Exception as e:
            print(f"❌ Error adding phone: {e}")
            return None
    
    def update_phone(self, name, description):
        """Update phone description"""
        try:
            resp = self.service.updatePhone(
                name=name,
                description=description
            )
            print(f"✅ Phone '{name}' updated")
            return resp
            
        except Exception as e:
            print(f"❌ Error: {e}")
            return None
    
    def delete_phone(self, name):
        """Delete a phone"""
        try:
            resp = self.service.removePhone(name=name)
            print(f"✅ Phone '{name}' deleted")
            return resp
            
        except Exception as e:
            print(f"❌ Error: {e}")
            return None

# Main execution
if __name__ == "__main__":
    # Initialize AXL client
    cucm = CUCMAxl(
        host='cucm.example.com',
        username='axluser',
        password='password',
        version='12.5'
    )
    
    # List all phones
    phones = cucm.list_phones()
    
    # Get specific phone
    if phones:
        cucm.get_phone(phones[0]['name'])

#!/usr/bin/env python3
"""
CUCM UDS API Example
User and device queries using REST
"""

import requests
from requests.auth import HTTPBasicAuth
import urllib3

urllib3.disable_warnings()

class CUCMUDS:
    """CUCM User Data Services Client"""
    
    def __init__(self, host, username, password):
        self.base_url = f"https://{host}:8443/cucm-uds"
        self.auth = HTTPBasicAuth(username, password)
        self.headers = {'Accept': 'application/json'}
    
    def get_user(self, userid):
        """Get user information"""
        url = f"{self.base_url}/user/{userid}"
        
        response = requests.get(
            url,
            auth=self.auth,
            headers=self.headers,
            verify=False
        )
        
        if response.status_code == 200:
            user = response.json()['user']
            print(f"\nUser: {user['userName']}")
            print(f"  First Name: {user['firstName']}")
            print(f"  Last Name: {user['lastName']}")
            print(f"  Email: {user.get('email', 'N/A')}")
            print(f"  Department: {user.get('department', 'N/A')}")
            return user
        else:
            print(f"❌ Error: {response.status_code}")
            return None
    
    def get_user_devices(self, userid):
        """Get devices associated with user"""
        url = f"{self.base_url}/user/{userid}/devices"
        
        response = requests.get(
            url,
            auth=self.auth,
            headers=self.headers,
            verify=False
        )
        
        if response.status_code == 200:
            devices = response.json()['devices']['device']
            print(f"\nDevices for user {userid}:")
            for device in devices:
                print(f"  - {device['name']} ({device['model']})")
            return devices
        else:
            print(f"❌ Error: {response.status_code}")
            return []

# Usage
uds = CUCMUDS('cucm.example.com', 'username', 'password')
user = uds.get_user('jsmith')
devices = uds.get_user_devices('jsmith')