isabella232 / siriproxy

A (tampering) proxy server for Apple's Siri

Siri Proxy

About

Siri Proxy is a proxy server for Apple's Siri "assistant." The idea is to allow for the creation of custom handlers for different actions. This can allow developers to easily add functionality to Siri.

The main example I provide is a plugin to control my thermostat with Siri. It responds to commands such as, "What's the status of the thermostat?", or "Set the thermostat to 68 degrees", or even "What's the inside temperature?"

Demo Video

See the system in action here:

http://www.youtube.com/watch?v=AN6wy0keQqo

Set-up Instructions

Currently, setup requires a pretty solid knowledge of certificates and openssl (or some good skills with Google). I'll see about providing automated scripts for generating the CA and relavent cert soon.

1. Create a root CA using open SSL and have it issue a signed certificate for guzzoni.apple.com. Save the guzzoni private key (no passphrase) and certificate as "server.passless.key" and "server.passless.crt" in the SiriProxy directory.
2. Load the root CA's public certificate on your phone (you can just email it to yourself and click it to do that).
3. Set up a DNS server on your network to forward requests for guzzoni.apple.com to the computer running the proxy (make sure that computer is not using your DNS server!). I recommend dnsmasq for this purpose. It's easy to get running and can easily handle this sort of behavior.
4. Install the requisite Ruby gems:
   • httparty
   • open-uri
   • json
   • CFPropertyList
   • pp
   • uuidtools
5. Execute start.rb (as root -- since it must listen on TCP/443)
6. Activate Siri on your phone (connected to the network and using the DNS server with the fake entry), and say, "Test Siri proxy." It should respond, "Siri Proxy is up and running!"

FAQ

Will this let me run Siri on my iPhone 4, iPod Touch, iPhone 3G, Microwave, etc?

Short answer: No.

Longer answer: While this doesn't let you do such a thing, it could HELP with such a thing. For instance, if you get Siri installed on your iPhone 4 (don't ask me how to do this, I really don't know), and you get someone to give you a valid iPhone 4S UIUD (don't ask me for mine, I will ignore your request), you could use this proxy in order to substitute the valid UIUD for your device's invalid UIUD. It would be pretty trivial. Of course, that would allow anyone with access to the proxy use your UIUD, so I'd recommend against that sort of action on anything externally accessible without performing some sort of authentication (might I suggest, checking the phone's UIUD? hehe).

How do I generate the certificate?

Here's some quick(-ish) steps on generating the fake CA and Guzzoni cert (on a Mac):

1. Open a terminal (go to spotlight, type "terminal")

2. Type:

   /System/Library/OpenSSL/misc/CA.pl -newca

3. Enter the following information:

   • CA certificate filename: hit enter, it will create a "demoCA" folder
   • Enter PEM pass phrase: give it something 4+ characters that you'll remember. Doesn't need to be complicated
   • Information (Country Name, State Name, etc): Just enter whatever. It's not important
   • Common Name: For the CA, this can be whatever. For the guzzoni certificate, it MUST be: "guzzoni.apple.com"

4. Type:

   /System/Library/OpenSSL/misc/CA.pl -newreq

5. Repeat step 3. Make sure you enter "guzzoni.apple.com" as your Common Name.

6. Type:

   /System/Library/OpenSSL/misc/CA.pl -sign

7. Enter the passphrase from the first time you did step 3.

8. Type "y" in response to each prompt.

9. Type:

   openssl rsa -in newkey.pem -out server.passless.key

10. Enter your passphrase from the second time you did step 3.

11. Type:

    mv newcert.pem server.passless.key

12. Move server.passless.crt and server.passless.key to your Siri Proxy server.

13. Email cacert.pem from your demoCA folder (created in step 2) to your iPhone. Once it's there, click it and accept it (it will give you scary warnings about this -- it should).

That's it! If you're more of a "follow a video" kind of person, here's a video demonstration of these steps:

http://www.youtube.com/watch?v=_oaNbPOUCaE

Will this work outside my home network?

No, it won't. But, as suggested by STBullard on YouTube, you COULD VPN into your home network from outside your house in order to make this work. That would not require a jailbreak. Of course, it also means ALL your traffic gets funneled through your home network. The nice thing about adding an entry to your /etc/hosts file (on a jailbroken phone) is that it funnels only Siri traffic through your home network, and not all your traffic.

Can you provide me with an iPhone 4S UIUD?

No. Don't even ask.

Acknowledgements

I really can't give enough credit to Applidium and the tools they created. While I've been toying with Siri for a while, their proof of concept for intercepting and interpreting the Siri protocol was invaluable. Although all the code included in the project (so far) is my own, much of the base logic behind my code is based on the sample code they provided. They do great work.

I also want to give a shout-out to Arch Reactor - my local Hackerspace. Hackerspaces are a fantastic place to go learn about stuff like this. I was able to get some help from folks there, and more importantly, I got encouragement to do stuff like this. Check Hackerspaces.org for a hackerspace in your area and make sure to check it out!

Licensing

Re-use of my code is fine under a Creative Commons 3.0 Non-commercial, Attribution, Share-Alike license. In short, this means that you can use my code, modify it, do anything you want. Just don't sell it and make sure to give me a shout-out. Also, you must license your derivatives under a compatible license (sorry, no closed-source derivatives). If you would like to purchase a more permissive license (for a closed-source and/or commercial license), please contact me directly. See the Creative Commons site for more information.

Disclaimer

I'm not affiliated with Apple in any way. They don't endorse this application. They own all the rights to Siri (and all associated trademarks).

This software is provided as-is with no warranty whatsoever. Apple could do things to block this kind of behavior if they want. Also, if you cause problems (by sending lots of trash to the Guzzoni servers or anything), I fully support Apple's right to ban your UIUD (making your phone unable to use Siri). They can, and I wouldn't blame them if they do.

I'm a huge fan of Apple and the work that they do. Siri is a very cool feature and I'm pretty excited to explore it and add functionality. Please refrain from using this software for anything malicious.

Also, this is my first project done in Ruby. Please don't be too critical of my code.