Microsoft 365 Community Community Demos, 24 Apr 2017

Previous Meeting Next Meeting

⏯

youtube image

►

From YouTube: Getting started with Office 365 CDN

Description

Showing how to get started with Office 365 CDN. Configuration using SharePoint Admin PowerShell cmdlets and how public and private CDN can be used with SharePoint sites.

A

Hello, my name is Jose Ronon and in this video we'll have a look on how to configure office 365 CDN and how to get started from an administrative perspective and how to use those CDN capabilities from a UI perspective in SharePoint Online. So let's actually get started right away with demo and the configuration so we're going to actually walk through how to enable a CDN and how we can then verify that it's a enabled and how we can use that within the SharePoint Online.

A

So in my case, I'm going to use visits to their code, which is a great tool for writing. Powershell, commandlets or powershell scripts as well. It's obviously up to you, which is what is your preference for your script, development and and the first that is, or to connect to your office, 365, tenant, administrative side or shipment online at Mississippi side. In my case, that is Versace admin and typically its whatever is their tenant name and then add in say postfix for that one. So, let's actually connect connect to my 10 on that mini site.

A

So I'm going to execute that by clicking f8 from my keyboard and then I'm going to sign in sign in to my tenant using my administrative information. So there we go if you would be using whatever multi-factor authentication models and all that 50 you I would actually reflect those changes as well, so that's 19, and then we are pretty much good to go on enabling or configuring and office 365 CDN for your tenant.

A

We can easily check that the connection that the tenant is available by, for example, executing get SPO tenant command, which will then show to default settings or the current settings of my tenant in office traces to fine. Now, okay, we can first check if, if the CDN is enabled so, let's actually execute, add to get SPO 10 on CD and enable command late and there's a switch wait to see their time. So I can actually do that for public and also for private or in my case, let's execute both of them to one execution.

A

So you can see that both of these configurations of both of these aliens are in fall studies. This is the default setting within all of the office traces to a tenant, so we're not enabling zan particle for anybody, and you can control that by yourself or the tenant administrator has to enable that within a tenant. Now, how do we then actually enable the tenant?

A

No, we have provided the super simplistic comment left with a set SPL tenant CDN enabled, and you can just provide the CDN type, which you want to enable one thing to notice here. Is that a no default origin option and which again actually provide us a parameter for this comment length, so no default origins would be the option for none and that will make sure that we're not actually enabling default options for that CDN time. So as an example for the public CDN, we are enabling the by library as the default origins for your CDN.

A

If you do not want to do that, and you can flip that now or control that by using that parameter in a common plant, but in my case I, don't really mind as I'm going to actually enable for both the public and private settings by the way. So, let's actually do that right away.

A

It is actually showing obviously the or showing warnings- and in here this thing this is a feature built for third-party applications with the privacy and compliance standards that deeper from commitments outlined by Microsoft Office 365 trusts enter any data cache through this service does not confirm Microsoft data processing terms- and this is outside of Microsoft Office, 365 trusts and they're compliant boundaries. So please be sure that you'll fine with those options, if you are I, can then enable those settings.

A

So let's actually write here, components actually right here in a so, we actually are a point for enabling the CDN and same applies for the other executions, one for the public and one for the private, then, and you to notice. Here we are saying explicitly cause of a pipe gift. I coach, a bkh, a B, G and tspn G is stored in the locations configure to service. A private CDN origins will now also be served and cash flow and content delivery network. So there are clear warnings around the around settings now for private.

A

We enabled, by default these dues to origins so user photo aspx as assigned asset. So if you would place any images or JavaScript files as an example to this site, assets folder- and you would reference then using a relevant relative path within a page. Those would automatically be served using the CDN for public option response, pointing down the default options on most debates and spy library, and these are then exposed using anonymous access using the public sit in the private seeding is always requiring authentication.

A

So it is actually checking that the user has the right permissions that those site assets when they're being served from the CDN as well. Maybe one thing to notice here and kind of a mention to be sure that whenever you're publishing any assets from site assets, you have a one-man major version populist of that asset as well, because you will need to have a major version available off the image or transcript file or whatever it is, and so it will be actually served using CD now moving along on the configuration.

A

So we now enabled both public and private CDN within this tenant. So we can actually set some of the convict some of the configurations for this, so let's actually get configuration for the for the public state in so get SBS and on CD and policies, and here because the few different additional configurations which again control so include file extensions, so default file, extensions which would be served from the CDN origins in the public CDN case, because we executed stereotype popping and then exclude restricted sight classifications.

A

So this is something with where you can actually say that hey if the site is classified to be, let's say, high business impact site, let's not serve anything outside of the forum, the public interested in and then there's a third option exclude if no script disabled so exclude this side. If no script option has been disabled kind of a difficult thing to figure out what does it mean? But it's the no script option by default, for example, for modern science, the no script is enabled for classic science.

A

It was by default disabled in the in the classic side, but it really depends on on your turn on settings as well for the private. If you have a look on quickly on those settings as well, settings are slightly different, so to include file extensions are slightly different, so by default in the private one, we have give I coach at the jpg, JavaScript and PNG. So these are static assets which typically do not contain any confidential information, their images and JavaScript files, which is business logic, but it's not actually on financial information for private setting.

A

The permissions do apply, so it doesn't actually matter if you're serving them from there for public seating. Those information all of these files are essentially available for anonymous requests, as long as somebody knows to URL, and the request is coming from a SharePoint Online as I prefer for HTTP requests. So this is a really important thing to see as well and you'll see this one in practice in the in the demo, when we actually take this settings into a use.

A

So, whenever you're referencing this once this only works when the river is shipment that come to depend on administer to SharePoint Online URL. So you cannot actually reference this as files or keep files of TDT files from sharepoint online if you would be want to host them, for example, in a custom web application in Microsoft issue. So this is typically designed for sharepoint online and the pages in the sharepoint online. So this video in this chat, seeding service, is checking that the repair is correctly set.

A

I'll show you that one in practice, when we get to the site and well-configured and start using actually the ceiling in essence, good. So right now we kind of went through the default, CDN origins and what the Syrian origin uses that hey. This is a location with with assets will be populous to sit in so by default, and the Syrian origins for public or, for example, was the most the page and most the page, and also the spy library configuration. So any most debates. Coloration is my library.

A

Configuration within a tenant would be by default, served to form a public CDN and again, you can configure this up to you lot of what is your settings in my case I'm, going to actually slightly configure these settings because I want to have a one specific folder which I'm going to use as my public CDN origin and then for my up Singh site I'm, going to configure an additional Syrian origin from where my images will be then served dynamically using the private CDN option.

A

So let me actually execute this one by one, so we're not causing additional configure confusion. So, let's actually get in here final, a OOP and that's actually my configuration there we go now. We can actually connect them so adding that one there and it's actually saying as an exception. So Syrian origin path must point to a SharePoint library and the way this is actually has expected- and this is good to know as well. So this is a great way of checking that your URL is properly configured so right now.

A

This is assuming that I have a slight CDN site underneath the side stuff and then I have a CDN, folder or library within my site. Currently, that's actually missing. So it's going to create that and reconfigure this. So here we are in the right location, I'm going to zoom in slightly so we can see that we are in my Testament and zds sites, less CDNs, the URL. So let me go to the site contents. Let me create my specific document library, which I will then configure as my CD and origin.

A

So let's call this CD in simple as it gets. Maybe can and obviously this document library can be anywhere within your tenant it can be and where you can use wildcard matching on the configuration as well. So this is pretty flexible from that perspective, so there we go now we have a URL which is my tenant. Url side CD ends in the end, so we can actually go back on the PowerShell and enable that location, and this time we should not actually get that exception and it's asking again and confirmation on it.

A

So, let's click 8 or say yes to all and the configuration will be applied and a good thing to notice here it is actually outputting. The default current of the CDN origins and my just added CNN origin is here listed as side, CD and CD and with an entry of configuration pending.

A

So this means that the configuration is now already applied on a sharepoint online sides and now sharepoint online is connecting to the CDN service and it is waiting for that configuration together with CDN service to be completed, and let's do the same for my publishing and for private side, private CDN, so I'm going to do that, one there as well, and we're going to show that one in a demo one does actually then means as well so configuration for the private CDN, adding that ends with their o and I'm missing, actually in origin path.

A

So that's actually goes at that side as well and create a new folder. So we can actually make this happen and we are in the right location. Cooper's. Let me create here, for example, assets doesn't really matter the document library name in this case. So, let's get that one created and let's configure that and see it in origin, it shouldn't take too long. There we go there's my asset, there's my URLs and can actually take that URL.

A

Don't have any typos in my execution, flipping back on the PowerShell, adding that one there properly there we go. Let's get rid of that leading juror and execute that one to my tenant as well. There we go execution and now we'll get a list of CDN origins and there we go. There's the default settings for CDN origins in a private side, so to use a photo side assets for publishing sides, and then there is my additional layer configuration for my parts on the side.

A

Now the configuration pending and can take up to 15 minutes to get completed. It really depends again on the how these two services, the SharePoint, Online and sit in service, are talking between each other and so we'll kind of pause. The video until we are in the situation where the configuration vending has been completed. So let's actually double check that one. So, for example, the public one is still in configuration pending stage. Most likely there we go, it is configuration pending.

A

So let's pause the video until that is completed, and then we can see the URLs and how we can take the CDN interviews in our sites.

A

So now, if we actually reacts acute this one and we can say that the our CDN origins for the application has already applied, so the configuration has been a point accordingly and let's double check the private CDN setting as well. So the configuration has been applied for that one as well. So there we go now. We can say that the sine of 35 assets has been configured on the side. Cdn Sirian has been configured as well.

A

So at this point the postilions are already fine when not actually going to move into removing this vidiians or origins or disabling the the CDN. But in practice you can use remote, remove SPO, tenancy and origins with the city and type and the origin. Url is the identifier for specific origin or you can disable the whole functionality that the public CDN or the private seed in using these two settings as well good. So what does it actually mean in practice? So let's go first in this side, so it's Eden's data.

A

Let's have a look on the public side and how does it actually work in practice, so I'm going to move back on my browser? Let's go to the CDN site. So here we go. Here's our CDN origin, which has been now configure the Stadion origin for the public stayed in. So what I'm going to do is that I'm going to track and drop one image in here and there we go. So let's try and drop that image in that's to stay a typical BMP, a square logo, so SharePoint BMP logo.

A

So it's actually close that one and now what we can do is that we are able to reference this logo using the public CD and the URL and Marica will able to format that by ourselves. So let me actually rename this lightly to be slightly more easily reference, so I can more easily reference none. So, let's do just logo be invades. This point for now, so I can show how it works in practice.

A

So the public student works in a way that you're able to reference these assets and within your customizations by using the puppet, alien and the bubble seeding is kind of a current Eid to remain the same. The URL format is as follows. So if I copy the basic structure here, we go and show you a double and let me actually zoom in on this one.

A

So you can actually see the URL format having a prefix of public seed in SharePoint, Online and comma, then the tenant host name and then sites as uncertain and site slash sites last library or if you're, pushing a hosting this path in the root site or root location. Then it will be just as library in here as well. So let's actually have a look on that one in practice. So how do I reference application where we have this local using this URL mask?

A

So let's actually take that one and change this a bit so I can actually take the URL, which is the vestige a at SharePoint con and update that one in the URL. Then it's sites, CDN is the site and actual site name. So let me update that.

A

Let me update that properly CDN library name- let's actually fix that title over there. Library name is CDN and then we actually rename that mess PNG logo dot PNG. So that should be now the URL for that image, which is now hosted from the public public CDN through our office, trees, fan city and optimization. So that means that I can actually reference that image or javascript file using that this path within my customizations or within my content as well. So let's actually test that one in practice.

A

So if I create a new page and I want to reference an image on that page there we go so, let's add an image here as well, and let's actually just to kind of do an image from a link to definitely inside so actually from a link. Let's ask link to the one on SharePoint Online not like that. Let me actually show you that in an alternative way, so let me actually go to the site contents. Let me create a not classic page, so I can more easily demonstrate this in practice.

A

So, let's come in here. Let's create a wiki point of wiki, page classic SharePoint page I'm, going to put a image in here as well. So, let's name the state.

A

This today is the X and then let's insert an picture from actress and now, if I use that URL in here as a copy that URL with a public, CD and prefix, my cannot name the location and logo.png if I click OK and if I click Save, we can actually say that damage is probably available in here and I can actually copy the image URL of our copy image address. And if I come in here, we can actually say that it's coming from the right location.

A

So this way we know that it's coming actually from the public state in one thing to notice here is that if I know, take a random browser and paste in this B&B logo. Here it works now, because I've actually accessed an already once in the page and but typically and typically when you reference these files, and you will always need to say typically, you will always need to have a river river coming from a sharepoint online. So only way you can actually make this work is that you are hosting.

A

They are referencing these images and assets from the pages which are located in here. So as an example, let me upload another file in here. So, if I go to the stadium folder and let's reference or and I'm gonna find, which is a B&B good, BMP PNG and let's actually build that properly, the URL as well B&B, dude PNG without any typos being they do it bein cheap.

A

There we go and if I now try to request that one, it will actually give me an exception which is invalid record, and this is as expected, because I'm actually trying to reference the BMP dude outside of the context of Chevron's online, so the referrer has to be SharePoint. Online just come and make all of this different properly.

A

Now, if I, however, put this one on the page, so let's actually update that one and reference that, in the context of sharepoint online picture from address and paste that one in there we go because that we are requesting the image or assets from a context of sharepoint online. This actually works probably and there's rpm. They do it rendered properly within the UI.

A

Excuse me, so you can use this. The public CDN, for example, for hosting JavaScript files, images, static images logos. All of that stuff. It is all of these assets are publicly or anonymously accessible, so people.

A

So you need to kind of be aware of that one as well, and this is for static ones and static assets, so not for aspx files or the cluster based files, because those are dynamic files which are not, which requires service and operations to get compound, and one of the use case, for example, for public stadion needs to use them for hosting sharepoint framework, client-side web part, javascript files and other assets like to chase some files and related on client side wet ones.

A

So as an example, you could just as well in the CDN, create a folder for all of the web parts, so do something like hello, world, hello, world web part and then reference. This URL dynamically within the client-side web part manifest, and then all the static files would be downloaded from here using the public, stadion cool. So what about the public private setting so credit seeding is something which is double checking or checking the permissions of the user which is requesting the assets.

A

So whenever the page the publishing beta is being rendered, it is actually at that time required checking that that person who is requesting that page is having access on that location and which is the private setting. If that's the case, then we'll render these assets using the private CDN location and the CDN. It doesn't matter if you're trying to request that that URL, which will be in the proceeding and using today well after it, has been resolved.

A

It doesn't work because the private CD and requires that you are alt, indicated against the sharepoint online under folder, where the assets are being hosted. So let's do the same, set up almost the same sign up for privacy, then as well. So this is the private pops inside and I'm, actually in the I've already configured this one as my CDN origin for private CDN, so that was the BOP 35 and assets, the folder which is configured in the private city and sides. So let me track control in image here as well.

A

So let's use to be in Bay, Square, small image and in this case, I'm not going to reference this, because actually I cannot reference this dynamically or by using just a rewriting of the URL, because that URL is changing a bit displaying the requests. So what I need to be doing doing is create a new page within my boxing site and if I reference these sunsets using a relative path, they will be automatically result using the private CDN.

A

So let's do that one in practice I'm going to go to the beta's library of my pops inside and let's create a new page in here OOP there we go there we go so let's create a new page in my passing site. Let's add a page: let's call this, for example, CDN demo.

A

Contest as well, I could have done that inside contents view, but that's fine. So let's call the CDN demo. That's the page and let's create the page here as well, and that's going to then open up the page whenever the page is available. So it's going to create it on the pages library and it's then it's going to open up the page, because I want to reference.

A

The image directly in my bait show that my all the rewriting of the URL works, which is enabled by default for the boppers in pages, so I, need to actually reference, that's relatively within the page and the easiest way. Obviously to do that is quickly to switch my base layer to emit some light as an example and then reference that image from the assets, folder or library. In this case, which has been enabled as a city in origin.

A

So we can actually see in practice how the image URL will be automatically transformed to come from the private CDN. So, let's go and select the image and my location was the assets folder on by default here. So, let's click that one as well and or let's click that one and insert so I can actually see that image being rendered. On my page there we go there's my image and I can publish the page.

A

So let's actually save the page, and in this case I didn't have versioning enables on the library so that there is a major version available of that asset automatically in the site. As my library case, there is actually the beta version enable you will need to make sure that your assets have been published as a one major version to make them visible through the private CDN and in my case well, we can do publish here as well. So debate itself is getting that getting deployed as well as a major version.

A

That's not specifically required for the scenario, but still that's to be our case just to make debate available within the boxing site. So now, if I right click this one and go be in its Atris, let's move to our note that we can actually see the image address being changed.

A

So the image I reference, the image using the relative path and I- can actually see that it's not being automatically served using the private CDN URL, which means that it's getting served from the private Sirian from the city on locations across the world so essentially meaning that the files will be loaded faster. We can still see that the URL prefix is pretty much the same as for the private CDN, but then there is the additional configuration which relates on the permissions and enhancing automatic handling of privacy there.

A

So additional additional configuration on the end of the URL but which you don't need the very about, but and that's actually the the tip part which is changing dynamically. So that's the reason why, if you reference this image using this URL now it will work for a while. But after a while it won't do any more work because there's a life cycle for these URLs. So the private seeding is something which you cannot really control.

A

It can be enabled, but you can control the URL of the private City and just to show this one in practice also in the developer tools. So if we have a look on the page in the chrome developer tools as an example, we can say the private, CD and sharepoint online and if I expand that- and we can say that we have the image available.

A

So the prefix for the URLs is private, CD and sharepoint online, and this are there's- is our CD in origin, from private sign and there's our image and it's getting served correctly from a page click that actually sums up the demo which we're going to be doing a walking through the different configurations just quickly, jumping back in here, a kind of a comp wind, pastry or very much estimation.

A

We do have the remove, remove SPO tenancy in origin works in the same way you define the CDN type and then the alright in URLs are able to actually get rid of their settings. One thing to notice on this is that when you are removing this CDN origins, there is a caching still applied. So if I know, for example, if I know remove the CD in public sitting, we will actually see a message here with the same content stored in the document.

A

Library, science in NC, then it's no longer search by content delivery network, while the effect is immediate. Caching, content still cached content scan will still be available in CDN and accessible everyone under mostly up to 30 days, and this relates on the client side. Caching- and it's really good to know that it's actually the default settings the default settings of this- the permit set in almost the same story, but the caching content is slightly different.

A

So the caching timeout is one hour here. We go contents sort in the document. Library, Papa 5:35 is no longer available from CDN. Cached content will still be available in the state and for up to one hour and after that, that's requests from a page. If you would request specifically that the URL would not actually work now, what's really important to realize that the private CD and we need disable or remove the content origin from a private City, and it will automatically fix this at the dates request.

A

So the following time, I will go to the page and request this focusing page. If I request this one again, this image is not actually coming from the private city and it is coming directly as a reference, the image from the location. So if we have a look again on the URL and let's have a look on that one as well, it's still on the private, but pretty soon it is actually updating itself automatically recognizing that a the Syrian origin has been removed for the private CDN.

A

So therefore I'm not going to render that through the city in I'm, going to render that through the normal URL without any additional configuration, what you should be doing from a Content user and a content editor perspective. You are working on the page like you used to do so. No changes from that perspective. It's referencing an image from the location and the private seating configuration is taking character, URL rewriting the CDN or not. You I'll, be writing good stadion and then coming back on the powershell. I can optionally.

A

We can absolutely also disable the CDN, so we were able to get both of these disabled.

A

So, let's get that one sample as well, and also the private Syrian to Stapleton discount in my case, doesn't matter but to form a demonstration perspective. Now the Syrians have been and stapled and that's it we're good to go so we walk through all of the different comment lights. We did a quick demo from a UI perspective for both posing so the private seed in and also how did we reference that the assets users from the public sit in? We are releasing updates on the documentation as we move along.

A

There will be documentation updates, depending on when you're, watching the video, obviously and to support of channels, and also the official MSDN documentation as well, but hopefully you'll find the demonstration useful, and this will help you to understand how to get started with illustrations device at 365 CDN and how to configure the different settings around the CDN consecration. Thank you.

A