Zulu - Integrating with Apple Calendars

From 360Works Product Documentation Wiki
Revision as of 16:06, 22 January 2019 by Martin (Talk | contribs)

Jump to: navigation, search
Zulu can integrate with Apple Calendars, allowing you to view your FileMaker calendars on Apple computers or iPhone.
Adding a CalDAV account on OSX

Contents

Prerequisites

Constructing Calendar URL

Whenever you publish your calendars, the resultant page has a section called "Add your calendar to iCal, iPhone, or iPad", which displays the calendar URL that Apple Calendar needs. This section is about how to construct that URL on your own so you understand the components of it.

The format of the calendar URL is:

http<s>://<your Zulu address>:<port>/zulu/calendars/<your database name>

You may notice that calendar URL reaches out to Zulu. Zulu intercepts communicate from Apple Calendar, converts it into FileMaker requests, then converts the result back from FileMaker into the format required for Apple Calendar. This is important because your Apple Calendar devices must be able to communicate with Zulu in order to work properly.

To give an example, say I had Zulu running on a machine with the address: "example.com", the database I have my calendars in is: "Zulu2SampleData", and I have a valid SSL certificate installed on that machine, which allows me to use https instead of http. The url for my calendars would be:

https://example.com/zulu/calendars/Zulu2SampleData

Another example, with the same server and database as above, but in this case, I had Zulu running on port 8080, and I was not using an SSL certificate of any kind. The calendar url would be:

http://example.com:8080/zulu/calendars/Zulu2SampleData

Note: Apple Calendar has gotten very picky in later versions about servers without SSL certificates. Frequently Apple Calendars will refuse to send credentials to Zulu, and the request will fail. To resolve this, try installing a valid SSL certificate on your Zulu server. If this is not an option for you, you can use the default FileMaker certificate, but you will need to add this certificate to the trust store on each device communicating with Zulu. See more on that below.

Adding Calendars to Apple Calendar

For OSX (Apple Computers)

CalDAV Account advanced settings
  • Open System Preferences -> Internet Accounts
  • In the list of account types the right, scroll down until you see "Add Other Account...". Click this.
  • Now look for the account type "CalDAV Account" and click this.
  • In the new menu, click the "Account Type:" dropdown menu and set it to "Advanced". This will show some additional fields we can use.
  • Now we need to populate each field with the correct values:
    • User Name: The FileMaker account user name that Zulu should use when fetching events
    • Password: The FileMaker account password that Zulu should use when fetching events
    • Server Address: The ip address or domain name where Zulu is running
    • Port: The port to access Zulu over. For http, use port 80. For SSL, use port 443.
    • Use SSL: Checking this box will make Apple Calendar use SSL for communication with Zulu. This will only work if the server running Zulu has an SSL certificate installed.
    • Use Kerberos v5 for authentication: Leave this unchecked.
Personal tools
Namespaces

Variants
Actions
Plug-in Products
Other Products
Navigation
Toolbox